home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-chang-iimc-proxy-02.txt < prev    next >
Text File  |  1993-06-07  |  165KB  |  3,723 lines
  1.  
  2.  
  3.  
  4.             INTERNET DRAFT                     Expires November 29, 1993
  5.  
  6.  
  7.  
  8.                   ISO/CCITT and Internet Management Coexistence (IIMC):
  9.  
  10.                          ISO/CCITT to Internet Management Proxy
  11.  
  12.                                        (IIMCPROXY)
  13.  
  14.                                          Draft 2
  15.                                       May 26, 1993
  16.  
  17.  
  18.                                   April Chang (Editor)
  19.  
  20.                                       NetLabs, Inc.
  21.                                    4920 El Camino Real
  22.                                    Los Altos, CA 94022
  23.                                     april@netlabs.com
  24.  
  25.  
  26.             Status of this Memo
  27.  
  28.             This document provides information to the network and systems
  29.             management community.  This document is intended as a
  30.             contribution to ongoing work in the area of multi-protocol
  31.             management coexistence and interworking.  This document is part
  32.             of a package; see also [IIMCOMIBTRANS] [IIMCIMIBTRANS] [IIMCMIB-
  33.             II] and [IIMCSEC]. Distribution of this document is unlimited.
  34.             Comments should be sent to the Network Management Forum IIMC
  35.             working group (iimc@thumper.bellcore.com).
  36.  
  37.             This document is an Internet Draft.  Internet Drafts are working
  38.             documents of the Internet Engineering Task Force (IETF), its
  39.             Areas, and its Working Groups.  Note that other groups may also
  40.             distribute working documents as Internet Drafts.
  41.  
  42.             Internet Drafts are draft documents valid for a maximum of six
  43.             months. Internet Drafts may be updated, replaced, or obsoleted
  44.             by other documents at any time.  It is not appropriate to use
  45.             Internet Drafts as reference material or to cite them other than
  46.             as a ``working draft'' or ``work in progress.''
  47.  
  48.             Please check the 1id-abstracts.txt listing contained in the
  49.             internet-drafts Shadow Directories on nic.ddn.mil, nnsc.nsf.net,
  50.             nic.nordu.net, ftp.nisc.sri.com, munnari.oz.au to learn the
  51.             current status of any Internet Draft.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.             Chang             Expires November 29, 1993           Page i
  64.  
  65.  
  66.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  67.  
  68.  
  69.  
  70.             Abstract
  71.  
  72.             This document is intended to facilitate the use of the ISO/CCITT
  73.             Common Management Information Protocol (CMIP) for integrated
  74.             management of networks via proxy management of TCP/IP networks
  75.             that are managed using Simple Network Management Protocol
  76.             (SNMP).  This document describes an ISO/CCITT to Internet
  77.             "proxy" which allows interworking between CMIP-based managers
  78.             and SNMP-based agents.  The proxy emulates CMIS service requests
  79.             by mapping between corresponding ISO/CCITT GDMO and Internet MIB
  80.             definitions, and generating SNMP message(s) needed to emulate
  81.             the service.  The proxy also emulates CMIS service responses and
  82.             notifications by converting incoming SNMP response and trap
  83.             message(s) in a similar fashion.  Thus, the proxy appears as a
  84.             CMIP-based agent to the manager, and as an SNMP-based manager to
  85.             the agent.  The proxy depends on the availability of
  86.             corresponding MIB definitions translated as described in
  87.             [IIMCIMIBTRANS].
  88.  
  89.             Table of Contents
  90.  
  91.             Status of this Memo ......................................i
  92.             Abstract    ..............................................ii
  93.             Table of Contents ........................................ii
  94.             Revision History .........................................iv
  95.             1  Introduction ..........................................1
  96.             1.1  Problem Statement ...................................1
  97.             1.2  Overview of IIMC ....................................1
  98.             1.3  MIB Translation Procedures ..........................2
  99.             1.4  Native Management Model .............................3
  100.             1.5  Proxy Management Model ..............................4
  101.             1.6  Scope of this Document ..............................5
  102.             1.7  Terms and Conventions ...............................8
  103.             2  ISO/Internet Proxy Configuration ......................10
  104.             2.1  ISO/Internet Proxy Containment Tree .................10
  105.             2.2  System Objects ......................................11
  106.             2.3  Translated MIB Schema Information ...................11
  107.             2.4  IIMC Party MIB Objects ..............................13
  108.             2.5  IIMC Proxy MIB Objects ..............................13
  109.             2.6  OMNIPoint 1 Capability Object .......................14
  110.             2.7  MIB Usage ...........................................15
  111.             2.8  Retained Information ................................16
  112.             3  Elements of CMIS Service Emulation ....................16
  113.             3.1  Association Service .................................16
  114.             3.2  Object Selection - Scoping and Filtering ............17
  115.             3.3  Management Operation Services .......................18
  116.             3.4  Synchronization .....................................21
  117.             3.5  M-GET Service .......................................22
  118.             3.6  M-CANCEL-GET Service ................................22
  119.             3.7  M-SET Service .......................................23
  120.             3.8  M-ACTION Service ....................................24
  121.             3.9  M-CREATE Service ....................................24
  122.             3.10  M-DELETE Service ...................................26
  123.  
  124.                            Chang             Expires November 29, 1993          Page
  125.  
  126.  
  127.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  128.  
  129.  
  130.             3.11  Management Notification Services ...................27
  131.             4  Common Procedures For CMISE Service Emulation .........28
  132.             4.1  Verifying Existence Of An Object Instance ...........28
  133.             4.2  Translating Timestamps ..............................28
  134.             4.3  Derivation of SNMP Request Parameters ...............29
  135.             4.4  Derivation Of CMIS Parameters .......................30
  136.             5  Error Message Translation .............................35
  137.             5.1  Translating SNMP Error Messages .....................35
  138.             5.2  CMIS Processing Failure .............................38
  139.             6  ISO/CCITT Systems Management Functions ................39
  140.             6.1  Event Report Management Function ....................39
  141.             6.2  Log Control Function ................................40
  142.             6.3  Scope of the EFD and Log ............................40
  143.             7  ISO/CCITT-Internet Proxy MIB ..........................41
  144.             7.1  Proxy MIB GDMO Templates ............................41
  145.             7.2  Proxy MIB ASN.1 Module ..............................46
  146.             8  Conformance Requirements ..............................48
  147.             8.1  Management Communication Requirements ...............48
  148.             8.2  Management Function Requirements ....................48
  149.             8.3  Management Information Requirements .................48
  150.             8.4  Service Emulation Requirements ......................49
  151.             9  Acknowledgments .......................................50
  152.             References  ..............................................52
  153.             Appendix A (Normative)
  154.                  Managed Object Conformance Statements (MOCS) ........55
  155.             Appendix B (Informative)
  156.                  Example Operation ...................................56
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                           Chang             Expires November 29, 1993         Page i
  186.  
  187.  
  188.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  189.  
  190.  
  191.  
  192.             Revision History
  193.  
  194.             Draft 0 - October 9, 1992
  195.                  Initial draft of this document.
  196.  
  197.             Draft 1 - March 28, 1993
  198.                  Previous draft of this document (replaced Draft 0).
  199.  
  200.             Draft 2 - May 26, 1993
  201.                  Current draft of this document (replaces Draft 1).
  202.  
  203.  
  204.             Major Changes Since Last Revision
  205.  
  206.             1.   Revised Naming to have multiple system instances,
  207.                  but without constraining what system is bound to.
  208.             2.   Modified the cmipsnmpProxyAgent object definition.
  209.             3.   Deleted all system management function subsections
  210.                  except those for Event Report Management and Log
  211.                  Control.  Defined the behaviour of EFD and Log.
  212.             4.   Reorganized Proxy MIB GDMO and ASN.1 module sections.
  213.             5.   Modified System Management Function requirements to
  214.                  include only optional support of AOM221 and AOM231.
  215.             6.   Added requirements for mandatory support of ISO DMI
  216.                  System, translated MIB2 internetSystem, and optional
  217.                  support of the OMNIPoint 1 capabilityObject.
  218.             7.   Modified minimum CMIP requirement to be AOM12, but
  219.                  minimum CMISE User requirement to be Kernel +
  220.                  Scoped Get.
  221.             8.   Added security defaults as a new object contained
  222.                  by the cmipsnmpProxyAgent object class.
  223.  
  224.             Outstanding Issues
  225.  
  226.             1.   Need to specify the semantics of the operational and
  227.                  usage state attributes in "remote system" objects.
  228.             2.   No "stateful" optimizations have been proposed.
  229.             3.   Refer to [IIMCIMIBTRANS] for outstanding issue regarding
  230.                  translation of conceptual tables; that proposal would
  231.                  also impact this IIMCPROXY specification.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                            Chang             Expires November 29, 1993          Page
  247.  
  248.  
  249.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  250.  
  251.  
  252.  
  253.             1  Introduction
  254.  
  255.             This section provides an overview of ISO/CCITT and Internet
  256.             Management Coexistence (IIMC) activities, insight into the
  257.             problem being addressed by IIMC, and a brief introduction to
  258.             the strategy adopted by IIMC: use of translated MIBs in either
  259.             a proxy or native implementation. The section concludes by
  260.             describing the scope of this document, and terms and
  261.             conventions used by this document.
  262.  
  263.             1.1  Problem Statement
  264.  
  265.             The need for enterprise network management has been addressed
  266.             by development of network management standards within various
  267.             communities, most notably the ISO/CCITT and Internet
  268.             communities.
  269.  
  270.             -    The ISO/CCITT community developed the Common Management
  271.                  Information Protocol (CMIP) [ISO9596-1], and related SMI
  272.                  documents [ISO10165-1,2,4].
  273.  
  274.             -    The Internet community developed the Simple Network
  275.                  Management Protocol (SNMP) [RFC1157], and its successor,
  276.                  SNMPv2 [RFC1448]. The Internet SMI is defined in
  277.                  [RFC1155] and [RFC1442].
  278.  
  279.             These standards share a nearly common management model, but
  280.             diverge due to differing management philosophies. Although
  281.             functionally similar, the Internet and ISO/CCITT protocols and
  282.             SMIs differ in terms of their complexity and specific
  283.             operations. Business requirements for end-to-end enterprise
  284.             management include the need to integrate the management of
  285.             components accessed by ISO/CCITT management, Internet
  286.             management, and proprietary management mechanisms in a manner
  287.             which presents a unified view of the network, despite protocol
  288.             and SMI differences.
  289.  
  290.             For example, many telecommunications and computer vendors,
  291.             represented by organizations such as the Network Management
  292.             Forum (NMF), and the U.S. government, as specified in the
  293.             Government Network Management Profile (GNMP), have based their
  294.             enterprise management model on the ISO/CCITT management model.
  295.             These organizations are particularly interested in integrated
  296.             management of devices that use the Internet management. This
  297.             interest is primarily due to the widespread commercial
  298.             implementation and use of such devices, especially devices
  299.             that use the Internet TCP/IP protocol suite.
  300.  
  301.             1.2  Overview of IIMC
  302.  
  303.             This document is part of a package of ISO/CCITT and Internet
  304.             Management Coexistence (IIMC) drafts.  Documents included in
  305.             this package are:
  306.  
  307.             Chang             Expires November 29, 1993           Page 1
  308.  
  309.  
  310.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  311.  
  312.  
  313.  
  314.             [IIMCIMIBTRANS]     Translation of Internet MIBs to ISO/CCITT 
  315.                                 GDMO MIBs
  316.  
  317.             [IIMCOMIBTRANS]     Translation of ISO/CCITT GDMO MIBs to
  318.                                 Internet MIBs
  319.  
  320.             [IIMCMIB-II]        Translation of Internet MIB-II (RFC1213)
  321.                                 to ISO/CCITT GDMO MIB
  322.  
  323.             [IIMCPROXY]         ISO/CCITT to Internet Management Proxy
  324.  
  325.             [IIMCSEC]           ISO/CCITT to Internet Management Security
  326.  
  327.             These documents together comprise a package aimed at
  328.             integrating ISO/CCITT-based and Internet-based management
  329.             systems.  These documents represent coexistence and
  330.             interworking efforts underway within the IIMC working group,
  331.             chartered under the auspices of the Network Management Forum
  332.             Architecture Integration ISO/Internet (AIII) technical team.
  333.  
  334.             The IIMC intends to address the problem that end-to-end
  335.             management requires an integrated, unified view of the managed
  336.             network, despite differences in management protocol and
  337.             information structure.  Integrated management can be
  338.             facilitated by the development of "proxy" mechanisms which
  339.             translate between functionally equivalent service, protocol,
  340.             and SMI differences to create this unified view.  MIB
  341.             translation procedures can be used to support proxy
  342.             management, as well as to take advantage of existing MIB
  343.             definition and avoid duplication of effort. In this way,
  344.             commercial investment in both ISO/CCITT and Internet-based
  345.             management technologies can be preserved through deployment of
  346.             common methods and tools which support integration.
  347.  
  348.             This overall strategy was outlined in a joint publication
  349.             developed by the NM Forum and X/Open entitled "ISO/CCITT and
  350.             Internet Management: Coexistence and Interworking Strategy"
  351.             [NMFTR107].  The documents included in the IIMC package are
  352.             the next level of detailed specifications which implement
  353.             several of the methodologies identified in the strategy.
  354.  
  355.             1.3  MIB Translation Procedures
  356.  
  357.             The foundation of IIMC is provided by a pair of Management
  358.             Information Base (MIB) translation procedures.
  359.  
  360.             -    [IIMCIMIBTRANS] specifies translation procedures for
  361.                  converting MIBs from Internet MIB macro format into
  362.                  ISO/CCITT GDMO template format.
  363.  
  364.             -    [IIMCOMIBTRANS] specifies translation procedures for
  365.                  converting MIBs from ISO/CCITT GDMO template format into
  366.                  Internet MIB macro format.
  367.  
  368.             Chang             Expires November 29, 1993           Page 2
  369.  
  370.  
  371.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  372.  
  373.  
  374.  
  375.             The IIMC approach is to specify direct translation procedures
  376.             which yield a pair of functionally-equivalent MIBs, as shown
  377.             in the following figure.
  378.  
  379.             +----------------+     +--------------------+     +----------------+
  380.             |  Internet MIB  |     |   MIB Translation  |     |    GDMO MIB    |
  381.             |                |     |     Procedures     |     |                |
  382.             |  Format =      |     |    Specified By    |     | Format =       |
  383.             |  [RFC1212] &   |---->| [IIMCIMIBTRANS] or |---->| [ISO10165-1] & |
  384.             |  [RFC1442]     |<----| [IIMCOMIBTRANS]    |<----| [ISO10165-4]   |
  385.             +----------------+     +--------------------+     +----------------+
  386.  
  387.             MIBs translated by these procedures may be used to take
  388.             advantage of existing MIB definitions when business needs
  389.             require deployment in a different management environment.
  390.             Translated MIBs may also be used to provide uniformity when
  391.             multiple management environments are supported by a single
  392.             system (e.g., dual stack managers). Finally, IIMC MIB
  393.             translation procedures may be used to support service
  394.             emulation by a proxy.
  395.  
  396.             1.4  Native Management Model
  397.  
  398.             The basic model for ISO/CCITT and Internet management is
  399.             illustrated in the following diagram.
  400.  
  401.                        Manager                               Agent
  402.              +-----------------------+            +----------------------+
  403.              |+---------------------+|            |+-------------------+ |
  404.              ||     Management      ||            ||      Managed      | |
  405.              ||    Applications     ||            ||     Resources     | |
  406.              |+---------------------+|            |+-------------------+ |
  407.              |   |                   |            |    |                 |
  408.              |   |                   |            |    |                 |
  409.              |+-----------+---------+|            |+----------+---------+|
  410.              ||  Manager  |   MIB   ||            ||  Agent   |   MIB   ||
  411.              |+-----------+---------+|            |+----------+---------+|
  412.              |    |                  |            |    |                 |
  413.              |    |  Management      |            |    |  Management     |
  414.              |    |   Services       |            |    |   Services      |
  415.              +-----------------------+            +----------------------+
  416.              |  Management Protocol  |            |  Management Protocol |
  417.              +-----------------------+            +----------------------+
  418.                          ^                                    ^
  419.                          |                                    |
  420.                          +------------------------------------+
  421.                                    Protocol Messages
  422.  
  423.             Within IIMC documents, this model is referred to as the
  424.             "native" management model. MIBs translated using IIMC
  425.             procedures can be used by "native" agent implementations.  For
  426.             example, an ISO/CCITT agent can make visible TCP/IP managed
  427.             resources using the translated GDMO version of the Internet
  428.  
  429.             Chang             Expires November 29, 1993           Page 3
  430.  
  431.  
  432.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  433.  
  434.  
  435.             MIB-II [RFC1213] specified by [IIMCMIB-II]. Dual-stack
  436.             managers or agents may also be implemented which support both
  437.             the original MIB and the translated MIB generated using IIMC-
  438.             specified procedures.
  439.  
  440.             1.5  Proxy Management Model
  441.  
  442.             The basic model for ISO/CCITT to Internet proxy management is
  443.             illustrated in the following diagram. This proxy is specified
  444.             by [IIMCPROXY]. A similar approach could also be taken to
  445.             specify an Internet to ISO/CCITT proxy, although no such IIMC
  446.             document is currently specified.
  447.  
  448.                       Manager                   Proxy                   Agent
  449.              +-----------------------+  +---------------------+  +------------------
  450.              |+---------------------+|  |+------+ +----------+|  |+-----------------
  451.              ||     Management      ||  || GDMO | | Internet ||  ||      Managed    
  452.              ||    Applications     ||  || MIB  | |   MIB    ||  ||     Resources   
  453.              |+---------------------+|  |+------+ +----------+|  |+-----------------
  454.              |      |                |  |+-------------------+|  |      |           
  455.              |      |                |  ||      Service      ||  |      |           
  456.              |      |                |  ||     Emulation     ||  |      |           
  457.              |      |                |  ||(scoping)          ||  |      |           
  458.              |      |                |  ||   (filtering)     ||  |      |           
  459.              |      |                   ||       (operations)||  |      |           
  460.              |+-----------+---------+|  |+-------------------+|  |+----------+------
  461.              || ISO/CCITT |   GDMO  ||  || Protocols Mapping ||  || Internet | Inter
  462.              ||  Manager  |   MIB   ||  ||  CMIS |...| SNMP  ||  ||  Agent   |   MIB
  463.              |+-----------+---------+|  |+-------------------+|  |+----------+------
  464.              |    |                  |  |  |CMIS           |  |  |    |             
  465.              |    | CMIS Services    |  |  |Services       |  |  |    | SNMP "Servic
  466.              |    |                  |  |  |               |  |  |    |             
  467.              |    |                  |  |  |           SNMP|  |  |    |             
  468.              |    |                  |  |  |     "Services"|  |  |    |             
  469.              +-----------------------+  +---------------------+  +------------------
  470.              |         CMIP          |  |   CMIP   |   SNMP   |  |        SNMP      
  471.              +-----------------------+  +---------------------+  +------------------
  472.                         ^                     ^         ^                   ^
  473.                         |                     |         |                   |
  474.                         +---------------------+         +-------------------+
  475.                              CMIP Messages                  SNMP Messages
  476.  
  477.             This ISO/CCITT to Internet proxy provides emulation of CMIS
  478.             services by mapping to the corresponding SNMP message(s)
  479.             necessary to carry out the service request. The service
  480.             emulation allows management of Internet objects by an
  481.             ISO/CCITT manager. The left hand side of the proxy behaves
  482.             like an ISO/CCITT agent, communicating with the ISO/CCITT
  483.             manager using CMIP protocols. The right hand side  of the
  484.             proxy behaves like an Internet manager, communicating with the
  485.             Internet agent using SNMP protocols.
  486.  
  487.             The proxy relies on the existence of a pair of directly-
  488.             related MIB definitions, where the Internet MIB has been
  489.  
  490.             Chang             Expires November 29, 1993           Page 4
  491.  
  492.  
  493.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  494.  
  495.  
  496.             translated into ISO/CCITT GDMO using the procedures specified
  497.             in [IIMCIMIBTRANS]. The proxy uses these MIB definitions and
  498.             rules to provide run-time translation of management
  499.             information carried in service requests and responses.
  500.  
  501.             The proxy is designed with a specified interface between the
  502.             proxy and the underlying protocol stacks, and so deals
  503.             primarily in terms of CMIS services and SNMP "services".  The
  504.             proxy emulates services such as CMIS scoping and filtering,
  505.             processing of CMIS operations, and forwarding/logging of CMIS
  506.             notifications by performing a mapping process which must be
  507.             tailored for each protocol (for example, SNMPv1 and SNMPv2 are
  508.             variants of the same protocol mapping process).
  509.  
  510.  
  511.             1.6  Scope of this Document
  512.  
  513.             The intent of this document (IIMCPROXY) is to facilitate the
  514.             use of ISO/CCITT CMIP-based managers to perform integrated
  515.             management of networks via proxy management of networks that
  516.             are accessed using Internet SNMP-based agents. There are two
  517.             major differences between CMISE and SNMP services: the
  518.             structure of management information, and the management
  519.             operations supported by the underlying protocols. The
  520.             ISO/Internet Proxy architecture as shown in section 1.2
  521.             provides CMISE service emulation. In another words, the
  522.             ISO/Internet Proxy acts as a CMIP-based agent with respect to
  523.             the manager, allowing management of Internet objects by the
  524.             ISO/CCITT manager.  CMIS requests are processed by the
  525.             ISO/Internet proxy and CMIS responses are returned by the
  526.             ISO/Internet proxy.  SNMP traps and Inform requests are
  527.             converted to CMIS notifications by the ISO/Internet proxy.
  528.             The implementation of the proxy requires that the Internet
  529.             MIBs be mapped to ISO/CCITT GDMO definitions.
  530.  
  531.             1.6.1  Approaches to Service Emulation
  532.  
  533.             As described by [NMFTR107], there are different approaches for
  534.             mapping Internet MIBs and ISO/CCITT MIBs.
  535.  
  536.             -    The "direct translation" approach maps each Internet
  537.                  object to a newly defined ISO/CCITT GDMO object that
  538.                  contains: 1) the same information as contained in the
  539.                  Internet object; and 2) the attributes that are inherited
  540.                  from the ISO/CCITT Top object class.
  541.  
  542.             -    The "abstract translation" approach maps Internet objects
  543.                  to different ISO/CCITT GDMO objects. For example, the
  544.                  MIB-II system object is similar to, and could be
  545.                  represented by, the ISO/CCITT system object. The abstract
  546.                  translation approach can also be used to map several
  547.                  Internet objects to a single ISO/CCITT GDMO object which
  548.                  provides only a summary view of the original Internet
  549.                  objects.
  550.  
  551.             Chang             Expires November 29, 1993           Page 5
  552.  
  553.  
  554.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  555.  
  556.  
  557.  
  558.             Either or both approaches could be used by an ISO/CCITT
  559.             manager to manage Internet agents. This document uses the
  560.             "direct translation" approach.
  561.  
  562.             To perform the CMISE service emulation, the ISO/Internet proxy
  563.             can use either of the approaches described by [NMFTR107] to
  564.             retrieve or modify Internet MIB information.
  565.  
  566.             -    In the "stateless" approach, the proxy does not maintain
  567.                  the Internet agent's MIB data.  Instead, for each
  568.                  received CMIS request, the ISO/Internet proxy generates
  569.                  one or more SNMP requests to the Internet agent in order
  570.                  to achieve the same intent of the CMIS request.
  571.  
  572.             -    The "stateful" approach requires the proxy to replicate
  573.                  an Internet agent's MIB locally, and to send periodic
  574.                  (unsolicited) requests to Internet agents to keep the
  575.                  replicated MIB current. The ISO/Internet proxy then tries
  576.                  to fulfill each incoming CMIS request by using locally-
  577.                  replicated MIB data, instead of sending SNMP requests to
  578.                  the Internet agent.
  579.  
  580.             The "stateful" approach will usually provide better response
  581.             time, but has the drawback that the data retrieved might not
  582.             be current. In this approach, the poll frequency used to
  583.             update the locally-replicated MIB has a significant effect on
  584.             the accuracy of the response.
  585.  
  586.             This document uses the "stateless" approach in which the proxy
  587.             responds to incoming CMIS requests by generating appropriate
  588.             SNMP requests. Furthermore, SNMP traps and inform requests are
  589.             converted to CMIS notifications.
  590.  
  591.             If necessary, the static Internet MIB data retrieved by the
  592.             ISO/Internet proxy could be cached by the proxy in order to
  593.             improve the response time of an operation.  This document
  594.             makes no assumption that the proxy caches static information,
  595.             and so takes no advantage of information which might be
  596.             cached.
  597.  
  598.             1.6.2  Proxy Inputs and Outputs
  599.  
  600.             This document describes a proxy which emulates CMIS services
  601.             through generation of appropriate SNMP protocols.  The proxy
  602.             is based on certain inputs and outputs, as shown below in
  603.             Tables 1 and 2.
  604.  
  605.             CMIS services [ISO9595] are supported by CMIP version 2
  606.             protocol [ISO9596-1].  SNMP protocols are as defined for
  607.             SNMPv1 [RFC1157] and SNMPv2 [RFC1448]. The emulation is
  608.             slightly different, depending upon whether SNMPv1 or SNMPv2
  609.             protocols are being used.
  610.  
  611.  
  612.             Chang             Expires November 29, 1993           Page 6
  613.  
  614.  
  615.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  616.  
  617.  
  618.             +------------------------------+----------------------+
  619.             | Service                      | Source               |
  620.             +------------------------------+----------------------+
  621.             | ACSE Associate Indication    | CMIP Stack           |
  622.             | ACSE Release Indication      | CMIP Stack           |
  623.             | ACSE Abort Indication        | CMIP Stack           |
  624.             | CMIS Get Indication          | CMIP Stack           |
  625.             | CMIS Cancel Get Indication   | CMIP Stack           |
  626.             | CMIS Set Indication          | CMIP Stack           |
  627.             | CMIS Create Indication       | CMIP Stack           |
  628.             | CMIS Delete Indication       | CMIP Stack           |
  629.             | CMIS Action Indication       | CMIP Stack           |
  630.             | CMIS Event Report Confirm    | CMIP Stack           |
  631.             | SNMPv1 Get Response          | SNMPv1 Stack         |
  632.             | SNMPv1 Trap                  | SNMPv1 Stack         |
  633.             | SNMPv1 Error                 | SNMPv1 Stack         |
  634.             | SNMPv2 Trap                  | SNMPv2 Stack         |
  635.             | SNMPv2 Get Response          | SNMPv2 Stack         |
  636.             | SNMPv2 Get Bulk Response     | SNMPv2 Stack         |
  637.             | SNMPv2 Inform Request        | SNMPv2 Stack         |
  638.             | SNMPv2 Error                 | SNMPv2 Stack         |
  639.             +------------------------------+----------------------+
  640.                           Table 1 - Proxy Inputs
  641.  
  642.             +------------------------------+----------------------+
  643.             |Service                       | Target               |
  644.             +------------------------------+----------------------+
  645.             | ACSE Associate Response      | CMIP Stack           |
  646.             | ACSE Release Response        | CMIP Stack           |
  647.             | ACSE Abort Request           | CMIP Stack           |
  648.             | CMIS Get Response            | CMIP Stack           |
  649.             | CMIS Cancel Get Response     | CMIP Stack           |
  650.             | CMIS Set Response            | CMIP Stack           |
  651.             | CMIS Create Response         | CMIP Stack           |
  652.             | CMIS Delete Response         | CMIP Stack           |
  653.             | CMIS Action Response         | CMIP Stack           |
  654.             | CMIS Event Report Indication | CMIP Stack           |
  655.             | SNMPv1 Get Request           | SNMPv1 Stack         |
  656.             | SNMPv1 Set Request           | SNMPv1 Stack         |
  657.             | SNMPv1 Get Next Request      | SNMPv1 Stack         |
  658.             | SNMPv2 Get Request           | SNMPv2 Stack         |
  659.             | SNMPv2 Set Request           | SNMPv2 Stack         |
  660.             | SNMPv2 Get Next Request      | SNMPv2 Stack         |
  661.             | SNMPv2 Get Bulk Request      | SNMPv2 Stack         |
  662.             +------------------------------+----------------------+
  663.                          Table 2 - Proxy Outputs
  664.  
  665.  
  666.             This document assumes that CMIP PDUs and SNMP PDUs received by
  667.             the ISO/Internet proxy are always properly encoded (i.e., the
  668.             underlying protocol stacks ensure the correctness of the
  669.             service indications and confirmations that are passed up to
  670.             the ISO/Internet proxy).
  671.  
  672.  
  673.             Chang             Expires November 29, 1993           Page 7
  674.  
  675.  
  676.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  677.  
  678.  
  679.  
  680.             The security architecture, services, protocols, and mechanisms
  681.             for the ISO/Internet proxy shall be as defined in [IIMCSEC].
  682.  
  683.  
  684.             1.7  Terms and Conventions
  685.  
  686.             This document assumes that the reader is familiar with
  687.             ISO/CCITT management and Internet management, and the
  688.             terminology of each. The term "SNMP" is used throughout this
  689.             document to indicate either SNMPv1 or SNMPv2, unless a
  690.             distinction needs to be made.
  691.  
  692.             Other terms and conventions used throughout this document
  693.             include the following.
  694.  
  695.             1.   ISO/CCITT manager: An application entity that implements
  696.                  [ISO9596-1] and acting in the manager role.
  697.  
  698.             2.   Internet agent: An application entity that supports the
  699.                  agent role of one or more of the SNMP protocols, such as
  700.                  [RFC1157] or [RFC1448].
  701.  
  702.             3.   ISO/Internet Proxy: An application entity that is
  703.                  responsible for emulating CMIS requests by a) generating
  704.                  SNMP requests, b) using SNMP responses to generate CMIS
  705.                  responses, and c) mapping SNMP Traps and InformRequests
  706.                  to CMIS notifications, all between a given (ISO/CCITT
  707.                  manager, Internet agent) pair. A proxy may concurrently
  708.                  support more than one (ISO/CCITT manager and Internet
  709.                  agent) pair.
  710.  
  711.             4.   Known Internet agents: A set of one or more Internet
  712.                  agents that an ISO/Internet proxy has knowledge of.  Each
  713.                  known Internet agent is represented by an instance of the
  714.                  proxy object. This document defines the
  715.                  cmipsnmpProxyAgent object class.
  716.  
  717.             5.   Known SNMP Parties: A set of one or more SNMP parties
  718.                  that an ISO/Internet proxy has knowledge of.  Each known
  719.                  SNMP party is represented by an instance of the
  720.                  partyTable object.  The partyTable object class is
  721.                  defined in [IIMCSEC].
  722.  
  723.             6.   Pseudo Object: A GDMO object class that does not contain
  724.                  any attributes which may be retrieved from an Internet
  725.                  agent (for example, a GDMO object class that represents a
  726.                  group in the Internet MIB-II, or any GDMO object classes
  727.                  representing Internet MIB tables).
  728.  
  729.             7.   Local object (instance): An object instance that is
  730.                  implemented by the proxy itself (for example, the
  731.                  cmipsnmpProxy and cmipsnmpProxyAgent classes defined in
  732.                  section 7).
  733.  
  734.             Chang             Expires November 29, 1993           Page 8
  735.  
  736.  
  737.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  738.  
  739.  
  740.  
  741.             8.   Remote object (instance): An object instance that
  742.                  physically resides within an Internet agent is considered
  743.                  a "remote object" (for example, Internet MIB-II objects
  744.                  like system, tcp, and udp).
  745.  
  746.             9.   Multiple Instance Object: An object class that may have
  747.                  more than one object instance. For example, Internet MIB
  748.                  table entries.
  749.  
  750.             10.  Delete Information: The object identifier of the
  751.                  attribute and its attribute value used to indicate that a
  752.                  particular row of a table is deleted.
  753.  
  754.             11.  Proxy System Object: The [ISO10165-2] DMI system managed
  755.                  object instance that represents the proxy itself.
  756.  
  757.             12.  Remote System Object: The [ISO10165-2] DMI system managed
  758.                  object instance that represents the remote proxied device
  759.                  on which the Internet agent resides.
  760.  
  761.             Abbreviations
  762.  
  763.             CMIP:     Common Management Information Protocol
  764.             CMIS:     Common Management Information Service
  765.             CMISE:         Common Management Information Service Element
  766.             DN:       Distinguished Name
  767.             MIB:      Management Information Base
  768.             MOC:      Managed Object Class (CMIP)
  769.             MOI:      Managed Object Instance (CMIP)
  770.             MIT:      Management Information Tree (naming tree)
  771.             OID:      ASN.1 Object Identifier
  772.             PDU:      Protocol Data Unit
  773.             RDN:      Relative Distinguished Name
  774.             SNMP:     Simple Network Management Information Protocol
  775.             SNMPv1:   Simple Network Management Information Protocol
  776.                       version 1 [RFC1157]
  777.             SNMPv2:   Simple Network Management Information Protocol
  778.                       version 2 [RFC1448]
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.             Chang             Expires November 29, 1993           Page 9
  796.  
  797.  
  798.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  799.  
  800.  
  801.  
  802.  
  803.             2  ISO/Internet Proxy Configuration
  804.  
  805.             In order for the ISO/Internet proxy to interwork with the
  806.             known Internet agents, the proxy needs to know initialization
  807.             information such as the transport address, network address,
  808.             protocol version, and security policy for each of the known
  809.             Internet agents. Such configuration may be done through an
  810.             off-line process, or through an on-line management exchange
  811.             not specified by this document.
  812.  
  813.             2.1  ISO/Internet Proxy Containment Tree
  814.  
  815.             The proxy shall support a forest of object instance trees,
  816.             each rooted at the ISO/CCITT system managed object defined by
  817.             [ISO10165-2], with one system object instance for each
  818.             supported Internet agent, and one system object instance for
  819.             the proxy itself.  Each ISO/CCITT system object is
  820.             distinguished by the value of its systemId or systemTitle
  821.             attribute, containing the name associated with the Internet
  822.             agent or proxy application.  This ISO/CCITT to Internet Proxy
  823.             containment tree is shown below.
  824.  
  825.                                 "Containment Object"
  826.                                      |
  827.                     +----------------+-+--------------------------+
  828.                     |                  |           ...            |
  829.                 Proxy System     Remote System 1         Remote System N
  830.                     |                  |                          |
  831.               +---+-+-----+      +---+-+---+                +--+--+----+
  832.               |   |  ...  |      |   | ... |                |  | ....  |
  833.               Objects in         Objects in                 Objects in
  834.               Proxy System       Remote System 1         Remote System N
  835.  
  836.  
  837.             The "Proxy System" is the [10165-2] "system" managed object
  838.             instance that represents the proxy itself.  The Proxy System
  839.             contains all objects representing resources within the proxy
  840.             itself, including the cmipsnmpProxy and cmipsnmpProxyAgent
  841.             managed objects.
  842.  
  843.             The "Remote System" is the [10165-2] "system" managed object
  844.             instance that represents the remote proxied device on which
  845.             the Internet agent resides. The Remote System contains all
  846.             objects that are implemented by the remote Internet agent.
  847.             These would include [IIMCMIB-II] "internetSystem", and any
  848.             other object supported by the Internet agent.
  849.  
  850.             All objects in the above containment tree can be accessed by
  851.             scoping from the "Containment Object". This may be an instance
  852.             of any managed object class. One possible "Containment Object"
  853.             is the so-called global root (i.e., "CCITT Rec. X.660 |
  854.             ISO/IEC 9834-1 : 1992":root).  In this case, scoped requests
  855.  
  856.             Chang             Expires November 29, 1993          Page 10
  857.  
  858.  
  859.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  860.  
  861.  
  862.             including all Remote Systems can be achieved by using a
  863.             management operation with the base object class equal to
  864.             "actualClass" and the base object instance name equal to "{}".
  865.             The proxy may support other alternative "Containment Objects";
  866.             this choice is left to the implementor.
  867.  
  868.             2.2  System Objects
  869.  
  870.             The "Proxy System" object particular to the proxy shall be
  871.             created automatically by the proxy during its local
  872.             initialization.
  873.  
  874.             The "Remote System" object particular to an Internet agent
  875.             system shall be automatically created/deleted by the proxy
  876.             when an associated cmipsnmpProxyAgent object instance in the
  877.             Proxy MIB is created/deleted. The Distinguished Name of this
  878.             system object shall have the same value as the cmipsnmpProxyId
  879.             attribute in the associated cmipsnmpProxyAgent object
  880.             instance.  Creation/deletion of the system object via
  881.             management operation is not allowed.
  882.  
  883.             The operationalState attribute of the "Remote System" object
  884.             indicates the perceived state of the Internet agent.  It is
  885.             the same as the operationalState attribute defined in
  886.             [ISO10165-2]. That is:
  887.  
  888.             -    The "enabled" state means that the Internet agent is
  889.                  operational, as perceived by the proxy, i.e., it can be
  890.                  reached.
  891.  
  892.             -    The "disabled" state means that the Internet agent is not
  893.                  operational, as perceived by the proxy, i.e., it  cannot
  894.                  be reached.
  895.  
  896.             The validity of the operationalState attribute is dependent on
  897.             the mechanisms used by the proxy to determine reachability,
  898.             and the frequency with which it is invoked.  For
  899.             connectionless environments (e.g., UDP), polling will have to
  900.             be performed by the proxy.  For connection oriented
  901.             environments (e.g., TCP), loss of connectivity as indicated by
  902.             lack of "keep alive" messages can be used to provide this
  903.             information.
  904.  
  905.             Editor's Note: [The intended semantic of these state
  906.             attributes requires further consideration.]
  907.  
  908.  
  909.             2.3  Translated MIB Schema Information
  910.             To perform CMISE service emulation, the ISO/Internet proxy
  911.             requires the Internet MIB's schema information, described in
  912.             ISO/CCITT GDMO templates. These templates shall be derived
  913.             from the original Internet MIB according to the procedures
  914.             defined by [IIMCIMIBTRANS].
  915.  
  916.  
  917.             Chang             Expires November 29, 1993          Page 11
  918.  
  919.  
  920.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  921.  
  922.  
  923.             The proxy run-time translation of parameters and protocol
  924.             translation procedures defined in this document depend on the
  925.             MIB translation, naming and registration procedures defined in
  926.             [IIMCIMIBTRANS]. The translation and registration procedures
  927.             defined in that document are structured such that the maximum
  928.             amount of information is preserved to facilitate the
  929.             translation process.
  930.  
  931.             An example containment tree for an agent supporting the
  932.             ISO/CCITT GDMO Internet MIB-II [IIMCMIB-II] (derived from the
  933.             Internet MIB-II [RFC1213]) is illustrated below. A proxy would
  934.             have multiple instances of such a tree for each Internet agent
  935.             supported. (The actual structure of the each containment tree
  936.             depends upon the MIB(s) supported by the proxy.)
  937.  
  938.             "Rec. X.721 | ISO/IEC 10165-2 : 1992" : system
  939.                  |
  940.                  |-- internetSystem
  941.                  |
  942.                  |-- at --- atTable --- atEntry
  943.                  |
  944.                  |-- egp --- egpNeighTable --- egpNeighEntry
  945.                  |
  946.                  |-- icmp
  947.                  |
  948.                  |-- interfaces --- ifTable --- ifEntry
  949.                  |
  950.                  |-- ip --- ipRouteTable --- ipRouteEntry
  951.                  |   |
  952.                  |   |---- ipAddrTable --- ipAddrEntry
  953.                  |   |
  954.                  |   |---- ipNetToMediaTable -- ipNetToMediaEntry
  955.                  |   |
  956.                  |   |---- ipForwardTable --- ipForwardEntry
  957.                  |
  958.                  |-- snmp
  959.                  |
  960.                  |-- tcp --- tcpConnTable --- tcpConnEntry
  961.                  |
  962.                  |-- udp --- udpTable --- udpEntry
  963.  
  964.  
  965.             As specified in [IIMCIMIBTRANS], name bindings for ISO/CCITT
  966.             GDMO object classes derived from Internet MIB table and entry
  967.             types can be automatically inferred from the Internet
  968.             registration hierarchy. Thus, object classes derived from
  969.             Internet conceptual table objects are bound to the object
  970.             class derived from the group with which the table is
  971.             associated. Object classes derived from Internet conceptual
  972.             table entries are bound to the table object classes with which
  973.             the tables entries are associated. Also, object classes
  974.             derived from Internet groups are bound to the ISO/CCITT system
  975.             object class.
  976.  
  977.  
  978.             Chang             Expires November 29, 1993          Page 12
  979.  
  980.  
  981.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  982.  
  983.  
  984.             2.4  IIMC Party MIB Objects
  985.  
  986.             Information regarding security policy when accessing agents is
  987.             contained in Party MIB objects. Binding the Party MIB objects
  988.             as subordinates of the system object which represents an
  989.             individual Internet agent allows security policy to be applied
  990.             on a per Internet agent basis. The Party MIB information can
  991.             be used by the proxy in a manager role when security services
  992.             enforcing security policy are implemented in the Internet
  993.             agent. The services enforced may be authentication, access
  994.             control, confidentiality and integrity as defined in
  995.             [RFC1446].
  996.  
  997.             In those situations where the agents may not implement the
  998.             access control security service on requests from the ISO/CCITT
  999.             manager (e.g., SNMPv1 agents), the proxy may enforce those
  1000.             services on behalf of the Internet agent. The policy regarding
  1001.             where access control is to be applied is controlled by
  1002.             variables in the cmipsnmpProxy and cmipsnmpProxyAgent managed
  1003.             objects defined in section 7.
  1004.  
  1005.             The policy regarding security services other than access
  1006.             control, must always be enforced by the Internet agent.
  1007.  
  1008.             A containment tree diagram for IIMC Party MIB managed object
  1009.             classes is illustrated below.  The IIMC Party MIB is
  1010.             subordinate to the ISO/CCITT system managed object that
  1011.             represents the Internet agent.
  1012.  
  1013.             "Rec. X.721 | ISO/IEC 10165-2 : 1992" : system
  1014.                  |
  1015.                  |-- partyTable --- partyEntry
  1016.                  |
  1017.                  |-- contextTable --- contextEntry
  1018.                  |
  1019.                  |-- aclTable --- aclEntry
  1020.                  |
  1021.                  |-- viewTable --- viewEntry
  1022.  
  1023.  
  1024.             2.5  IIMC Proxy MIB Objects
  1025.  
  1026.             The IIMC Proxy MIB defines a set of objects for specifying the
  1027.             information that is needed for both community-based and party-
  1028.             based SNMP management on a per Internet agent basis.
  1029.  
  1030.             The Proxy MIB consists of a cmipsnmpProxy managed object which
  1031.             contains cmipsnmpProxyAgent object instances, one for each
  1032.             agent being managed by the proxy. The cmipsnmpProxy object
  1033.             class is an immediate subordinate of the "Proxy System" object
  1034.             class. The cmipsnmpProxy object also contains an
  1035.             snmpSecurityParameter object instance which contains default
  1036.             security information.
  1037.  
  1038.  
  1039.             Chang             Expires November 29, 1993          Page 13
  1040.  
  1041.  
  1042.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1043.  
  1044.  
  1045.             Each cmipsnmpProxyAgent object has information which
  1046.             identifies an Internet agent and how the agent may be reached.
  1047.             Its naming attribute, which contains the administratively-
  1048.             assigned name of the managed device where the Internet agent
  1049.             is located, is used in the naming tree to identify the SNMP
  1050.             managed device.
  1051.  
  1052.             Creation of a cmipsnmpProxyAgent object instance to represent
  1053.             an Internet agent shall result in the instantiation of a
  1054.             corresponding "Remote System" object representing the Internet
  1055.             agent. The naming attribute value of the "Remote System" shall
  1056.             be the same as the name of the corresponding
  1057.             cmipsnmpProxyAgent object instance.  It is recommended that a
  1058.             "OP1 Library Vol. 4":capabilityObject be created for the proxy
  1059.             also.
  1060.  
  1061.             The cmipsnmpProxyAgent object may be created by management
  1062.             operation, or automatically.  For example, the proxy may
  1063.             support discovery of Internet agents, whereby the discovered
  1064.             Internet agents, associated system object, and capability
  1065.             object shall be created automatically by the proxy itself.
  1066.  
  1067.             This document refers to instances of IIMC Proxy MIB object
  1068.             classes as "local objects" or as "local object instances".
  1069.  
  1070.             A containment tree diagram for ISO/CCITT proxy MIB managed
  1071.             object classes is illustrated below.
  1072.  
  1073.             "Rec. X.721 | ISO/IEC 10165-2 : 1992" : system
  1074.                  |
  1075.                  +-- cmipsnmpProxy
  1076.                      |
  1077.                      +--cmipsnmpProxyAgent
  1078.                      |
  1079.                      +--snmpSecurityParameter
  1080.  
  1081.             IIMC Proxy MIB GDMO definitions are described in section 7.
  1082.  
  1083.             2.6  OMNIPoint 1 Capability Object
  1084.  
  1085.             If used, the "OP1 Library Vol.4":capability object particular
  1086.             to an Internet agent system shall be automatically created and
  1087.             deleted by the proxy when the associated cmipsnmpProxyAgent
  1088.             object in the Proxy MIB is created and deleted.
  1089.  
  1090.             The following text describes one possible implementation of
  1091.             gathering information defined in the Capability object's
  1092.             supportedObjectClassList.  When the cmipsnmpProxyAgent is
  1093.             created, or when the supportedObjectClassList attribute
  1094.             changes, the proxy shall find out all the object classes
  1095.             defined in all the GDMO documents described in the
  1096.             supportedMIBs attribute.  The proxy then forms an SNMP Get
  1097.             Next Request with all the object classes (translated to the
  1098.             OID used by the Internet agent) in a variable binding list to
  1099.  
  1100.             Chang             Expires November 29, 1993          Page 14
  1101.  
  1102.  
  1103.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1104.  
  1105.  
  1106.             find out whether a particular object class is supported by the
  1107.             Internet agent. The proxy then fills the
  1108.             supportedNameBindingList by finding out all the name bindings
  1109.             used by the object classes in the supportedObjectClassList.
  1110.  
  1111.             2.7  MIB Usage
  1112.  
  1113.             The information described in sections 2.1 through 2.6 is
  1114.             maintained by the proxy and used to perform run-time
  1115.             translation between corresponding CMIS and SNMP parameters.
  1116.  
  1117.             The following definitions are extracted from [IIMCIMIBTRANS]
  1118.             clause 2.3.1, where (c) and (a) refer to class and attribute,
  1119.             respectively.
  1120.  
  1121.             From [IIMCIMIBTRANS] clause 2.1:
  1122.  
  1123.                  {classOID}     ::= {iimcAutoTrans
  1124.                                      <internetEntityId>(c)}
  1125.  
  1126.                  and
  1127.  
  1128.                  {attributeOID}  ::= {iimcAutoTrans
  1129.                                      <internetEntityId>(a)}
  1130.  
  1131.             From [IIMCIMIBTRANS] clause 2.2, the ISO/CCITT naming
  1132.             attribute value contains the OID formed as:
  1133.  
  1134.                  (naming attribute)  ::=  {iimcAutoTrans
  1135.                                            <internetEntityId>(c)
  1136.                                            <internet instanceId>}
  1137.  
  1138.             where the "()" indicates "contents of".
  1139.  
  1140.             The <internet instanceId> (the OID created uniquely for each
  1141.             Internet object instance) is "0" for object classes that may
  1142.             only have a single instance.  The <internet instanceId> for
  1143.             object classes that may have multiple instances is an OID
  1144.             fragment derived from the values of the internet objects
  1145.             identified in the INDEX (or AUGMENTS) clause of the Internet
  1146.             Macro from which the object class is derived, as defined in
  1147.             [RFC1155] or [RFC1442].
  1148.  
  1149.             The Internet uses the following convention to uniquely
  1150.             identify an Internet object instance:
  1151.  
  1152.                  {internet object name}::= {<internetEntityId>(a)
  1153.                                            <internet instanceId>}
  1154.  
  1155.             Refer to [IIMCIMIBTRANS] for additional detail.
  1156.  
  1157.             2.8  Retained Information
  1158.  
  1159.  
  1160.  
  1161.             Chang             Expires November 29, 1993          Page 15
  1162.  
  1163.  
  1164.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1165.  
  1166.  
  1167.             The proxy must retain information obtained from the ISO/CCITT
  1168.             manager during association establishment, and for individual
  1169.             CMIS requests on the association.
  1170.  
  1171.             For each outstanding CMIS request, the proxy needs to maintain
  1172.             the ISO/CCITT invoke id, object class and object instance.
  1173.             When SNMP responses are received, the proxy shall use the
  1174.             retained information to form the associated parameters in CMIS
  1175.             responses.
  1176.  
  1177.             For scoped CMIS requests, the proxy shall maintain some state
  1178.             information to keep track of the portion of the Internet MIB
  1179.             that is being traversed.
  1180.  
  1181.  
  1182.             3  Elements of CMIS Service Emulation
  1183.  
  1184.             The following sections describe the conceptual process for
  1185.             performing CMIS service emulation.  In an actual
  1186.             implementation, it should be possible to combine some of the
  1187.             processing.  It is highly recommended that the implementors of
  1188.             the ISO/Internet proxy combine the processes where possible to
  1189.             optimize the implementation.
  1190.  
  1191.  
  1192.             3.1  Association Service
  1193.  
  1194.             The proxy should provide the association service as defined in
  1195.             section 8.1 of [ISO9596-1].  This service includes association
  1196.             establishment and association release.
  1197.  
  1198.             In ISO/CCITT systems management, management entities may
  1199.             exchange initialization information during the association
  1200.             establishment phase. Such information is used only by the
  1201.             proxy for its own configuration and is not conveyed to the
  1202.             communicating Internet agents.
  1203.  
  1204.             This document does not define any application context;
  1205.             however, a proxy may be required to support the following
  1206.             application contexts as defined in the ISO standards and CCITT
  1207.             recommendations:
  1208.  
  1209.                  ISO Systems Management application context; or
  1210.                  CCITT TMN application context one.
  1211.  
  1212.             CMIP and SMASE functional units may be negotiated between the
  1213.             ISO/CCITT manager and the ISO/Internet proxy. Once a set of
  1214.             functional units is agreed, the proxy will ensure only the
  1215.             agreed services are accepted over the association.
  1216.  
  1217.             The CMIP protocol used between the ISO/CCITT manager and the
  1218.             ISO/Internet proxy is a connection-oriented protocol which
  1219.             requires an association be maintained throughout the
  1220.             management exchange(s). The protocol between the proxy and the
  1221.  
  1222.             Chang             Expires November 29, 1993          Page 16
  1223.  
  1224.  
  1225.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1226.  
  1227.  
  1228.             Internet agent, however, may be a connection-less protocol
  1229.             which does not require the existence of an association. Upon
  1230.             receiving an association request from the ISO/CCITT manager,
  1231.             the proxy needs to determine whether connectivity to the agent
  1232.             is possible so that it may accept or reject the association
  1233.             request accordingly.  The mechanism used by a proxy to detect
  1234.             the "reachability" of an Internet agent is implementation-
  1235.             dependent, and is not within the scope of the document.
  1236.  
  1237.             For example, if the reliability of the association is not
  1238.             essential to its management applications, a proxy may assume
  1239.             its Internet agents are always reachable, and may accept
  1240.             association requests on that basis. In this approach, the
  1241.             proxy would terminate the association only when it detects the
  1242.             Internet agent is not reachable.
  1243.  
  1244.  
  1245.             3.2  Object Selection - Scoping and Filtering
  1246.  
  1247.             Managed object selection is used to identify a set of managed
  1248.             object instances in the management information tree (MIT) to
  1249.             which a CMIS request applies.  Managed object selection is
  1250.             performed in two phases: scoping; and then, filtering. Scoping
  1251.             is used to select candidate object instances in the MIT to
  1252.             which operations may apply. A filter is then applied to
  1253.             attributes of the previously scoped object instances in order
  1254.             to identify the subset of object instances on which the CMIS
  1255.             operation is to be performed.
  1256.  
  1257.             If no filter is specified, the CMIS request will be performed
  1258.             for all object instances identified by the scope parameter. If
  1259.             no scope parameter is specified, the default is the base
  1260.             managed object instance only.
  1261.  
  1262.             There are different ways of performing the scoping operation,
  1263.             depending on the implementation. This document specifies one
  1264.             possible way of providing the managed object selection
  1265.             service.
  1266.  
  1267.             The proxy has no direct knowledge of current object instances
  1268.             that exist in the Internet agent. Therefore, it must first
  1269.             determine the existence of an object before it knows whether
  1270.             it is within the scope.  Obviously, all objects in the scope
  1271.             must be instances of object classes that are within the scope.
  1272.             Thus, the proxy should first determine the set of object
  1273.             classes within the scope, and then discover what instances of
  1274.             those object classes actually exist in the Internet agent.
  1275.             This set of object classes that are within the scope are
  1276.             called the "object class group" (OCG).
  1277.  
  1278.             The following pseudo code algorithm specifies a generic method
  1279.             of determining the members of an "object class group".
  1280.  
  1281.  
  1282.  
  1283.             Chang             Expires November 29, 1993          Page 17
  1284.  
  1285.  
  1286.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1287.  
  1288.  
  1289.             Define the set of object classes at the current level in the
  1290.             naming tree that are being processed as the "class level
  1291.             group" (CLG).
  1292.  
  1293.             Define the set of object classes at the next level in the
  1294.             naming tree that are to being processed after the CLG as the
  1295.             "next level group" (NLG).
  1296.  
  1297.             Define the managed object class named by the incoming request
  1298.             as the "base managed object" (BMO).
  1299.  
  1300.             Minimum Level and Maximum Level are derived from the CMIS
  1301.             scope parameter.
  1302.  
  1303.             CLG = {BMO};
  1304.             OCG = {}; /* empty set */
  1305.             currentScope  = 0;
  1306.  
  1307.             WHILE ( currentScope <= Maximum Level )
  1308.                  NLG = {children of objects in CLG};
  1309.                  IF (currentScope > Minimum Level)
  1310.                            THEN OCG = {union of OCG and CLG};
  1311.                  CLG = NLG;
  1312.                  currentScope = currentScope + 1;
  1313.                  ENDWHILE;
  1314.  
  1315.             The determination of the set NLG as {children of objects in
  1316.             CLG} may be done using implementation-dependent internal data
  1317.             structures of the proxy.
  1318.  
  1319.             An alternative method to determine NLG is to use the name
  1320.             binding templates directly.  The following algorithm could
  1321.             then be used to determine the NLG.
  1322.  
  1323.             WHILE (CLG not equal to {})
  1324.                  Remove an object from CLG;
  1325.                  FOR (all name bindings in this proxy's associated
  1326.                       Capability object)
  1327.                       IF object == SUPERIOR
  1328.                            THEN NLG = {union of the
  1329.                                      SUBORDINATE object and NLG};
  1330.                            ENDFOR;
  1331.                  ENDWHILE;
  1332.  
  1333.  
  1334.             3.3  Management Operation Services
  1335.  
  1336.             If the specified instances (i.e., those selected by scoping
  1337.             process) are "local objects", the proxy performs the services
  1338.             using local means.
  1339.  
  1340.             If the specified instances are "remote objects", then the
  1341.             following steps apply.  Any objects that physically reside in
  1342.             the Internet agents are considered "remote objects".  For
  1343.  
  1344.             Chang             Expires November 29, 1993          Page 18
  1345.  
  1346.  
  1347.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1348.  
  1349.  
  1350.             example, Internet MIB II objects like system, tcp, and udp are
  1351.             considered "remote objects".
  1352.  
  1353.             1)   Determine if the attributes specified by the filter
  1354.                  expression (if any) belong to the object class. If not,
  1355.                  then remove the object class from the object class group.
  1356.  
  1357.             2)   If the object is a pseudo object (table object), then
  1358.                  there is only one possible instance and the values of the
  1359.                  attributes are known locally to the proxy.  The pseudo
  1360.                  object exists if and only if there exists a non-pseudo
  1361.                  subordinate object (table entries).  The proxy shall
  1362.                  attempt to determine if there exists a non-pseudo
  1363.                  subordinate object by issuing an SNMP GetNext Request
  1364.                  using as an argument the Internet object name for the
  1365.                  pseudo object, <internetEntityId>(c).  If the SNMP
  1366.                  response contains an Internet object that translates to
  1367.                  an attribute of a child of the pseudo object, then the
  1368.                  pseudo object exists.  If the pseudo object does not
  1369.                  exist, then remove it from the object class group.
  1370.  
  1371.             3)   If the object is not a pseudo object, then determine if
  1372.                  an instance of the object exists by attempting to
  1373.                  retrieve, for the first instance, all of the attributes
  1374.                  specified in the CMIS filter and the attributeId list or
  1375.                  attribute list.
  1376.  
  1377.                  i)   For single instance objects, use an SNMP Get Request
  1378.                       or GetNext Request, with the parameters translated
  1379.                       according to section 4.
  1380.  
  1381.                  ii)  For multiple instance objects, use an SNMP GetNext
  1382.                       Request, with the parameters translated as shown in
  1383.                       section 4.  This will result in the retrieval of the
  1384.                       first instance of the translated Internet objects
  1385.                       (i.e., a table entry). If the resulting table entry
  1386.                       has been deleted, or is otherwise unavailable for
  1387.                       retrieval, then go to step 5.
  1388.  
  1389.             4)   Apply the filter to the attributes of the object instance
  1390.                  identified in steps 2 and 3.
  1391.  
  1392.                  i)   If the filter evaluates to FALSE, then perform no
  1393.                       further processing on the object.  However, for
  1394.                       multiple instance objects, save the results of step
  1395.                       3 part (ii).
  1396.  
  1397.                  ii)  If the filter evaluates to TRUE, then attempt to
  1398.                       perform the operation on the object, as follows.
  1399.  
  1400.                       -    If the CMIS operation was M-GET, then the M-GET
  1401.                            has been completed from the Internet agent.
  1402.                            Formulate the appropriate CMIS M-GET response
  1403.                            and send it to the manager.
  1404.  
  1405.             Chang             Expires November 29, 1993          Page 19
  1406.  
  1407.  
  1408.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1409.  
  1410.  
  1411.  
  1412.                       -    If the CMIS operation was M-SET, then perform
  1413.                            the corresponding SNMP Set Request on the
  1414.                            Internet objects. When the SNMP Response
  1415.                            returns, formulate the appropriate CMIS M-SET
  1416.                            response and send it to the manager.
  1417.  
  1418.                       -    If the CMIS operation was M-CREATE, then
  1419.                            perform the create on the Internet objects
  1420.                            (conceptual row elements) using the algorithm
  1421.                            appropriate to the object. When the create
  1422.                            process is finished, formulate the appropriate
  1423.                            CMIS M-CREATE response and send it to the
  1424.                            manager.
  1425.  
  1426.                       -    If the CMIS operation was M-DELETE, then
  1427.                            perform the delete on the Internet objects.
  1428.                            When the SNMP Response returns, formulate the
  1429.                            appropriate CMIS M-DELETE response and send it
  1430.                            to the manager.
  1431.  
  1432.             5)   For multiple instance objects, use an SNMP GetNext
  1433.                  Request, with the parameters translated according to
  1434.                  section 4, and with the <internet instanceId> set to the
  1435.                  values retrieved for the previous instances for all
  1436.                  Internet object names. This will result in the retrieval
  1437.                  of the next instance of the translated Internet objects.
  1438.                  If the Internet object instances are not of the same type
  1439.                  as those requested, then all instances of the multiple
  1440.                  instance object class have been processed; go to step 6.
  1441.                  If the Internet object instances are of the same type as
  1442.                  those requested then retain the results of the GetNext
  1443.                  Request for the next iteration and repeat steps 4 and 5.
  1444.  
  1445.                  In order to reduce the amount of traffic generated by
  1446.                  multiple Get-Next requests, the proxy could use the
  1447.                  SNMPv2 Get-Bulk request with the non-repeaters
  1448.                  parameter set to zero and the max-repetitions set to
  1449.                  some arbitrary value (either by guessing or based on
  1450.                  previous knowledge). Setting non-repeaters to zero 
  1451.                  makes the Get-Bulk operation behave like Get-Next.
  1452.  
  1453.             6)   Attempt to select another object class from the object
  1454.                  class group.  If one exists then go to step 1; otherwise,
  1455.                  return an appropriate final CMIP PDU (e.g., empty M-GET
  1456.                  or M-SET response) and quit processing the request.
  1457.  
  1458.  
  1459.             3.4  Synchronization
  1460.  
  1461.             If the ISO/Internet proxy receives a CMIS "atomic" request,
  1462.             but cannot perform the operation atomically, the
  1463.             "synchronization not supported" CMIS error response should be
  1464.             returned to the ISO/CCITT manager.
  1465.  
  1466.             Chang             Expires November 29, 1993          Page 20
  1467.  
  1468.  
  1469.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1470.  
  1471.  
  1472.  
  1473.             If SNMPv1 is used, the types of atomic requests that the
  1474.             ISO/Internet proxy can perform are as follows.
  1475.  
  1476.             1)   If all the instances selected by a scoped CMIS request
  1477.                  are "local object instances", then the ISO/Internet proxy
  1478.                  can perform the CMIS request locally (and atomically);
  1479.                  and
  1480.  
  1481.             2)   If the CMIS request can be performed by the ISO/Internet
  1482.                  proxy using a single SNMP request, then the operation can
  1483.                  also be performed atomically.
  1484.  
  1485.             In SNMPv1, either a Get or Set operation would fail if
  1486.             the operation on any selected variable(s) failed. This
  1487.             remains true for SNMPv2 Set operations, but not for
  1488.             SNMPv2 Get operations. Using SNMPv2, if you request 4
  1489.             variables in a Get request, and there is an error in one
  1490.             of the variables, you get a response with 3 valid values
  1491.             and one error.  The proxy shall fail a CMIS "atomic"
  1492.             request if the corresponding SNMPv2 Get operation is only
  1493.             partially successful.
  1494.  
  1495.             For a "best effort" request, the ISO/Internet proxy should try
  1496.             to perform the request on all the instances specified by the
  1497.             request. Since the SNMP protocol supports only "atomic"
  1498.             operations, an operation (especially an SNMP Set Request
  1499.             operation) on multiple variables may be rejected if the
  1500.             operation on any one of the selected variables failed. Upon
  1501.             receiving such an error, the proxy should retry the request by
  1502.             sending multiple requests with each request containing only a
  1503.             single variable. In the time window in which these SNMP
  1504.             requests are being processed, another SNMP Set Request could
  1505.             be issued which could modify the value of a selected variable.
  1506.             For this reason, the complete integrity of a CMIS scoped
  1507.             request cannot be guaranteed.  A proxy which complies with
  1508.             this document is not required to detect or avoid this
  1509.             situation, and will not usually report any error if this
  1510.             situation occurs.
  1511.  
  1512.  
  1513.             3.5  M-GET Service
  1514.  
  1515.             The following sub-sections describe how the M-GET service may
  1516.             be emulated.  Upon receiving a CMIS M-GET request, the proxy
  1517.             first verifies the existence of the based managed object. The
  1518.             procedures for verifying the existence of a managed object is
  1519.             described in section 4.1.
  1520.  
  1521.             3.5.1  Form The Request
  1522.  
  1523.             If the CMIS request's attributeIdList parameter is empty
  1524.             (selects all attributes), the proxy shall query the schema
  1525.  
  1526.  
  1527.             Chang             Expires November 29, 1993          Page 21
  1528.  
  1529.  
  1530.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1531.  
  1532.  
  1533.             information to find out what attributes are specified for the
  1534.             requested object class.
  1535.  
  1536.             If the CMIS request's attribute specifies a non-null
  1537.             attributeIdList, the proxy shall verify that the identified
  1538.             attribute(s) are specified for the object class.  If the
  1539.             identified attribute is not specified in the object class, the
  1540.             proxy shall return a noSuchAttribute CMIS error without
  1541.             sending SNMP requests to the Internet agent.
  1542.  
  1543.             For all attributes that are specified in the object, an SNMP
  1544.             Get or SNMP GetNext Request shall be formed, based on the
  1545.             mapping specified in section 4. Use of SNMP Get or GetNext is
  1546.             an implementation issue; however, SNMP GetNext is recommended
  1547.             for performance reasons. Since some non-conforming agents may
  1548.             not implement all the object types in an object group, SNMPv1
  1549.             Get would return a noSuchName error in this case, and the
  1550.             proxy will need to remove the non-implemented variable binding
  1551.             and resend the SNMP Request. If SNMP GetNext is used instead,
  1552.             the proxy would either discard the non-implemented attribute
  1553.             or translate the SNMP Response to appropriate CMIS
  1554.             getListError.
  1555.  
  1556.             3.5.2  Form The Response(s)
  1557.  
  1558.             The proxy shall form the CMIS response according to the
  1559.             mappings specified in section 4.
  1560.  
  1561.             If the CMIS request's attributeIdList is null (selects all
  1562.             attributes), the proxy shall never return the CMIS
  1563.             getListError. If the Internet agent does not implement all the
  1564.             variables in an object (which violates conformance to the SNMP
  1565.             specification), the proxy shall form the CMIS M-GET response
  1566.             with all the attributes implemented by that Internet agent.
  1567.  
  1568.             If the CMIS request's attributeIdList selects all attributes,
  1569.             the proxy shall supply in all the attributes that are
  1570.             inherited from the ISO/CCITT Top object in the CMIS response.
  1571.  
  1572.             3.6  M-CANCEL-GET Service
  1573.  
  1574.             The M-CANCEL-GET operation shall be performed as described in
  1575.             [ISO9596-1]. The ISO/Internet proxy does not need to generate
  1576.             any SNMP Requests in order to emulate the CMIS M-CANCEL-GET
  1577.             request. However, upon receiving an M-CANCEL-GET request, the
  1578.             ISO/Internet proxy shall stop sending further CMIS M-GET
  1579.             responses to the ISO/CCITT manager for the canceled M-GET
  1580.             request. Furthermore, the proxy shall not initiate further
  1581.             SNMP Requests to the Internet agent for the canceled M-GET
  1582.             request. If the Internet agent continues to return SNMP Get
  1583.             responses corresponding to the canceled M-GET request, they
  1584.             shall be discarded by the proxy.
  1585.  
  1586.  
  1587.  
  1588.             Chang             Expires November 29, 1993          Page 22
  1589.  
  1590.  
  1591.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1592.  
  1593.  
  1594.             Depending on when an M-CANCEL-GET request is received, the
  1595.             proxy may send out different responses for the canceled M-GET
  1596.             request and for the M-CANCEL-GET request.
  1597.  
  1598.             If the Invoke Id of the M-GET request to be canceled is not
  1599.             recognized by the proxy, the proxy shall return a "no such
  1600.             invoke identifier" CMIS error to the ISO/CCITT manager. This
  1601.             can happen when the proxy has not received such an M-GET
  1602.             request, or when the proxy has completed the identified M-GET
  1603.             request.
  1604.  
  1605.             An M-GET operation is considered completed if the
  1606.             corresponding M-GET response has been sent. For the single
  1607.             object M-GET case, this means the sending of a single M-GET
  1608.             response. For the scoped multiple object case, this means the
  1609.             sending of the final empty M-GET response for the linked
  1610.             replies.
  1611.  
  1612.             If the identified M-GET request was received, but has not been
  1613.             completed, the proxy generates an "operation canceled error"
  1614.             to the ISO/CCITT manager as a response to the canceled M-GET
  1615.             request. In this case, the proxy will also acknowledge the
  1616.             successful completion of the M-CANCEL-GET request to the
  1617.             ISO/CCITT manager.
  1618.  
  1619.             3.7  M-SET Service
  1620.  
  1621.             The following sections describe how M-SET service may be
  1622.             emulated. Upon receiving a CMIS M-SET request, the proxy
  1623.             verifies the existence of the based managed object, according
  1624.             to the procedures defined in section 4.1.
  1625.  
  1626.             3.7.1  Perform The Set Operation
  1627.  
  1628.             For each selected ISO/CCITT object instance, the proxy would
  1629.             generate one or more SNMP Set Requests to modify the
  1630.             attributes identified by the CMIS modificationList parameter,
  1631.             according to the specified modify operator. Only the "replace"
  1632.             modify operator is supported by the ISO/Internet proxy. The
  1633.             modify operator is optional and if it is not specified in a
  1634.             CMIS request, the "replace" operator should be assumed.
  1635.  
  1636.             The CMIS "add value" and "remove value" modify operators are
  1637.             not supported by SNMP protocol, and are not supported by the
  1638.             ISO/Internet proxy. Since SNMP uses default values only for
  1639.             initialization (i.e. at creation time), the "set to default"
  1640.             modify operator is not supported by the ISO/Internet proxy
  1641.             either. If the modify operator value included in an M-SET
  1642.             request is not supported, "invalid operator" should be
  1643.             reported in the CMIS setListError response.
  1644.  
  1645.             3.7.2  Form The Response(s)
  1646.  
  1647.  
  1648.  
  1649.             Chang             Expires November 29, 1993          Page 23
  1650.  
  1651.  
  1652.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1653.  
  1654.  
  1655.             If the M-SET request is a "confirmed" request, the proxy shall
  1656.             construct an M-SET response. The CMIS M-SET response should
  1657.             contain the attribute values list or the appropriate
  1658.             setListError. Once the CMIS M-SET response has been
  1659.             constructed, it is passed to the CMIP service provider, which
  1660.             send the corresponding CMIP PDU to the ISO/CCITT manager.
  1661.  
  1662.             If the CMIS M-SET request is a scoped request, attribute
  1663.             values of each ISO/CCITT object are reported as a linked
  1664.             reply.
  1665.  
  1666.             3.8  M-ACTION Service
  1667.  
  1668.             Since Internet MIBs do not have any actions defined, the
  1669.             translation of CMIS M-ACTION to corresponding SNMP operations
  1670.             is not needed. Any CMIS M-ACTION request which is received
  1671.             pertaining to a translated Internet MIB object will be
  1672.             rejected by the proxy with an "noSuchAction" error response.
  1673.             However, CMIS M-ACTION may be used by the proxy for other
  1674.             purposes.
  1675.  
  1676.             3.9  M-CREATE Service
  1677.  
  1678.             3.9.1  Request Validation
  1679.  
  1680.             The ISO/Internet proxy is responsible for validating that
  1681.             incoming CMIS M-CREATE requests do not violate name binding
  1682.             and object class definitions.
  1683.  
  1684.             3.9.2  Name Binding
  1685.  
  1686.             The ISO/Internet proxy must determine if an instance may be
  1687.             created according to the CREATE clause of the NAME BINDING
  1688.             template specified for the object class. If the instance
  1689.             cannot be created, the CMIS error response
  1690.             "classInstanceConflict" is returned.
  1691.  
  1692.             The ISO/Internet proxy must also determine from the NAME
  1693.             BINDING template if the instance specified in the request
  1694.             maybe created under the superior object instance identified in
  1695.             the M-CREATE request. If the NAME BINDING does not specify the
  1696.             identified containment relationship, an "invalidOperation"
  1697.             CMIS error response should be returned.
  1698.  
  1699.             3.9.3  Check For Duplication
  1700.  
  1701.             The proxy must determine if the instance already exists.  If
  1702.             it does, a "duplicate managed object instance" CMIS error
  1703.             response should be returned.
  1704.  
  1705.             3.9.4  With Referenced Object
  1706.  
  1707.  
  1708.  
  1709.  
  1710.             Chang             Expires November 29, 1993          Page 24
  1711.  
  1712.  
  1713.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1714.  
  1715.  
  1716.             If a CMIS M-CREATE request includes a reference object, the
  1717.             ISO/Internet proxy should retrieve the referenced object
  1718.             instance from the Internet agent.
  1719.  
  1720.             The proxy uses an SNMP GetNext Request for retrieval, with the
  1721.             parameters translated according to section 4, and with the
  1722.             <internet instanceId> set to the translated <internet
  1723.             instanceId> of the reference object for all Internet object
  1724.             names.
  1725.  
  1726.             The proxy checks if the attribute used for SNMP row creation
  1727.             indicates that the row is not available for use (e.g., has
  1728.             been deleted or is in some other not ready condition).  This
  1729.             attribute is the CREATEDELETEATT attribute indicated in the
  1730.             scannable portion of table entries translated according to
  1731.             [IIMCIMIBTRANS]. (Note that this attribute is always defined
  1732.             as GET only in the translated GDMO MIB.)
  1733.  
  1734.             If the reference object instance does not exist, the proxy
  1735.             must send a "No such reference object" CMIS error response to
  1736.             the ISO/CCITT manager.
  1737.  
  1738.             3.9.5  With Automatic Instance Naming
  1739.  
  1740.             A CMIS M-CREATE request can use automatic instance naming to
  1741.             form a name for the object instance to be created. Automatic
  1742.             instance naming is used if: a) a CMIS M-CREATE request does
  1743.             not specify a distinguished name for the object instance to be
  1744.             created; and b) the request specifies an object class that has
  1745.             a name binding allowing automatic instance naming.
  1746.  
  1747.             It is the responsibility of the ISO/Internet proxy to select
  1748.             an instance name based on the behavior of the object class and
  1749.             name binding. In some cases, the relative distinguished name
  1750.             (RDN) is formed using attributes provided in the CMIS M-CREATE
  1751.             request. For example, the RDN for the Internet MIB-II
  1752.             "atEntry" could be formed from the "atNetIfIndex" attribute
  1753.             and the "atNetAddress" attribute. In other cases, the RDN can
  1754.             be assigned by the ISO/Internet proxy.
  1755.  
  1756.             If the superior object instance is not specified, the
  1757.             ISO/Internet proxy  cannot create the object instance and a
  1758.             "processing failure" CMIS error should be returned.
  1759.  
  1760.             3.9.6  Perform The Create Operation
  1761.  
  1762.             The CMIS M-CREATE is realized by setting the status column of
  1763.             the corresponding Internet MIB table entry to a valid value
  1764.             with all other columns of the table entry properly
  1765.             initialized. If the combination of the attributes specified in
  1766.             the CMIS M-CREATE request and the attributes obtained from the
  1767.             reference object do not provide a complete set of attribute
  1768.             values for all of the mandatory attributes for the entry
  1769.             specified by the object class being instantiated, then the
  1770.  
  1771.             Chang             Expires November 29, 1993          Page 25
  1772.  
  1773.  
  1774.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1775.  
  1776.  
  1777.             ISO/Internet proxy should still try to create the object with
  1778.             all the available attributes.
  1779.  
  1780.             If the actual creation process with the incomplete attribute
  1781.             list succeeds, the ISO/Internet proxy should retrieve all the
  1782.             attributes of the newly-created entry, including the
  1783.             attributes which have values supplied by the Internet agent
  1784.             with using default values. This complete list of attribute
  1785.             values is returned in the CMIS M-CREATE response.
  1786.  
  1787.             If the actual creation process with this partial attribute
  1788.             list fails, the ISO/Internet proxy sends a "missing attribute
  1789.             value" CMIS error back to the ISO/CCITT manager.
  1790.  
  1791.             3.9.7  Form The Response
  1792.  
  1793.             The results from the Internet agent are used by the proxy to
  1794.             construct a CMIS M-CREATE response, which is then returned to
  1795.             the ISO/CCITT manager, using the mappings defined by section
  1796.             4.
  1797.  
  1798.             3.10  M-DELETE Service
  1799.  
  1800.             3.10.1  Perform the Delete Operation
  1801.  
  1802.             For all the selected ISO/CCITT object instances, the following
  1803.             procedures should be taken.
  1804.  
  1805.             3.10.2  Name Binding
  1806.  
  1807.             Determine from the NAME BINDING template if the instance
  1808.             specified in the request may be deleted.  If the name binding
  1809.             does not allow the deletion of the identified object, a CMIS
  1810.             error response is returned.
  1811.  
  1812.             3.10.3  Perform The Delete Operation
  1813.  
  1814.             If the object instance identified in the CMIS M-DELETE request
  1815.             exists, the delete operation is performed. In SNMPv1, object
  1816.             deletion is achievable only if there is a columnar object
  1817.             representing the status of each conceptual row. Deleting an
  1818.             object instance is realized by setting the status columnar
  1819.             object to an invalid value. The value representing "invalid"
  1820.             is implementation-specific. The proxy therefore needs to be
  1821.             aware of the "invalid" value and the status columnar object in
  1822.             order to perform the deletion. For SNMPv2, the object deletion
  1823.             can be achieved by sending an SNMP Set Request to the Internet
  1824.             agent to change the Row Status value to "destroy."
  1825.  
  1826.             3.10.4  Form The Response(s)
  1827.  
  1828.             This process includes formatting the CMIP M-DELETE response
  1829.             with the appropriate attribute list or deleteListError
  1830.  
  1831.  
  1832.             Chang             Expires November 29, 1993          Page 26
  1833.  
  1834.  
  1835.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1836.  
  1837.  
  1838.             parameters. Once the CMIS M-DELETE response has been
  1839.             constructed, it is returned to the ISO/CCITT manager.
  1840.  
  1841.  
  1842.             3.11  Management Notification Services
  1843.  
  1844.             Although SNMPv1 and SNMPv2 use different PDU structures to
  1845.             convey Traps, all SNMP Traps are mapped to the IIMC-defined
  1846.             internetAlarm notification and sent as CMIS M-EVENT-REPORTs.
  1847.             Since SNMP Traps are not confirmed, the translated CMIS M-
  1848.             EVENT-REPORTs are sent as "unconfirmed" event reports.
  1849.  
  1850.             If the SNMPv2 manager-to-manager communication is supported
  1851.             between an Internet manager and an ISO/CCITT manager, it is
  1852.             possible for the proxy to receive an InformRequest from the
  1853.             Internet system.  Like Traps, InformRequests are also mapped
  1854.             to CMIS M-EVENT-REPORTs. Unlike Traps, the internetAlarm
  1855.             notifications resulting from InformRequests are sent as
  1856.             "confirmed" event reports.
  1857.  
  1858.             If the translation of Traps to notifications fails, no CMIS M-
  1859.             EVENT-REPORT will be generated and the SNMP Traps are simply
  1860.             discarded.
  1861.  
  1862.             The proxy shall expect a CMIS M-EVENT-REPORT response for all
  1863.             internetAlarm notifications sent in confirmed mode. The CMIS
  1864.             M-EVENT-REPORT response shall contain an empty event report
  1865.             argument.  Upon receipt of the CMIS M-EVENT-REPORT response,
  1866.             the proxy shall return an SNMP Response PDU to the Internet
  1867.             agent that is in accordance with SNMPv2 protocol rules and
  1868.             contains an error code of "noError".
  1869.  
  1870.             If the translation of an SNMPv2 InformRequest to a CMIS M-
  1871.             EVENT-REPORT fails, the proxy shall send an SNMP Response to
  1872.             the originator of the SNMP InformRequest with the error code
  1873.             of "genErr".
  1874.  
  1875.             If the proxy  cannot determine the Internet agent that
  1876.             initiated the SNMP Trap, then the CMIS M-EVENT-REPORT shall be
  1877.             sent as if it originated from the cmipsnmpProxy managed object
  1878.             class. This can occur when there are multiple agents
  1879.             associated with the same network address or when the proxy is
  1880.             unable to recognize the network address. Otherwise, the proxy
  1881.             should always be able to determine the originator from the
  1882.             network address in the Trap message and the event will be sent
  1883.             as if it originated from the MIB-II internetSystem under the
  1884.             remote system.
  1885.  
  1886.             Refer to section 6 for additional information regarding
  1887.             discrimination of notifications.
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.             Chang             Expires November 29, 1993          Page 27
  1894.  
  1895.  
  1896.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1897.  
  1898.  
  1899.  
  1900.  
  1901.             4  Common Procedures For CMISE Service Emulation
  1902.  
  1903.  
  1904.             The procedures described in this section are used during CMISE
  1905.             service emulation defined in section 3. These procedures are
  1906.             collected together here for ease of specification, and to
  1907.             facilitate common implementation.
  1908.  
  1909.  
  1910.             4.1  Verifying Existence Of An Object Instance
  1911.  
  1912.             Since the proxy does not maintain a replicate copy of the MIB
  1913.             data maintained by the Internet agents, the existence of the a
  1914.             managed object, such as a based managed object specified in an
  1915.             incoming CMIS request, may need to be verified before further
  1916.             processing, such as scoping and filtering.
  1917.  
  1918.             If the base object specified in the request does not exist in
  1919.             the Internet agent, then the proxy must send a
  1920.             "NoSuchObjectInstance" CMIS error response back to the
  1921.             ISO/CCITT manager.
  1922.  
  1923.             If the base managed object is a pseudo object,  the
  1924.             ISO/Internet proxy tries to determine if there exists a non-
  1925.             pseudo subordinate object. The base object exists if and only
  1926.             if there exists a non-pseudo subordinate object.
  1927.  
  1928.  
  1929.             4.2  Translating Timestamps
  1930.  
  1931.             This document does not specify a standard translation for the
  1932.             timestamp value in CMIS responses.  However, the following
  1933.             paragraphs describe two potential implementations for this
  1934.             translation: ISO/Internet proxy's local time, and Internet
  1935.             agent's local time with fixed unknown delta.
  1936.  
  1937.             4.2.1  ISO/Internet Proxy's Local Time
  1938.  
  1939.             The timestamp value in the CMIS response can be set to the
  1940.             time provided by the ISO/Internet proxy's internal clock when
  1941.             the final SNMP Response is received to complete processing of
  1942.             a given CMIS request.
  1943.  
  1944.             4.2.2  Internet Agent's Local Time
  1945.  
  1946.             The ISO/Internet proxy can query the Internet agent for
  1947.             "sysUpTime", in addition to the original SNMP variable binding
  1948.             list in the first SNMP Request. Using this method, this value
  1949.             is recorded as the "agent's initial sysUpTime" and the
  1950.             ISO/Internet proxy's local time is recorded as "initial
  1951.             contact time".
  1952.  
  1953.  
  1954.             Chang             Expires November 29, 1993          Page 28
  1955.  
  1956.  
  1957.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  1958.  
  1959.  
  1960.             Each CMIS request is then translated to one or more SNMP
  1961.             Requests by the ISO/Internet proxy to fulfill the CMIS
  1962.             request. If the last SNMP Request for the same CMIS request is
  1963.             an SNMP Get Request, the "sysUpTime" is added into the SNMP
  1964.             variable binding list. Otherwise, an extra SNMP Get Request is
  1965.             issued with "sysUpTime" as the only element in the variable
  1966.             binding list. This new "sysUpTime" is called "agent's current
  1967.             sysUpTime".
  1968.  
  1969.             The timestamp in the last CMIS response is then calculated as
  1970.             follows: initial contact time + (agent's current sysUpTime -
  1971.             agent's initial sysUpTime).
  1972.  
  1973.             This approach eliminates the inaccuracy caused by network
  1974.             delay between the ISO/Internet proxy and Internet agent, and
  1975.             gives the ISO/CCITT manager a more accurate indication of when
  1976.             the operation was actually performed by the Internet agent
  1977.             (rather than the time that the response processed by the
  1978.             ISO/Internet proxy).
  1979.  
  1980.             However, in order to convert the sysUpTime, which is the time
  1981.             ticks since the system was last re-initialized, to the CMIS
  1982.             event time, the proxy must be made aware of every
  1983.             reinitialization of the Internet agents. Although each
  1984.             Internet agent generates a Trap when it first comes up, there
  1985.             is no guarantee that the proxy will receive this Trap.
  1986.             Therefore, this method may also be inaccurate.
  1987.  
  1988.             4.3  Derivation of SNMP Request Parameters
  1989.  
  1990.             4.3.1  SNMPv2 Party and Context Parameters
  1991.  
  1992.             The SNMPv2 source/destination party and context parameters
  1993.             shall be derived from the values in the privileged attribute
  1994.             certificate (PAC) passed in the access control parameter of
  1995.             the incoming ACSE or CMIS request.
  1996.  
  1997.             If no incoming access control parameter is received, the proxy
  1998.             shall use the default context and parties in the
  1999.             snmpSecurityParameter object instance contained by the
  2000.             cmipsnmpProxyAgent.  If no default applies, the operation
  2001.             shall be rejected by the proxy with an access denied error.
  2002.  
  2003.             4.3.2  SNMPv1 Community String Parameter
  2004.  
  2005.             The SNMPv1 community string parameter shall be derived from
  2006.             the value in the privileged attribute certificate(PAC) passed
  2007.             in the access control parameter of the ACSE or CMIS request.
  2008.  
  2009.             If no incoming access control parameter is received, the proxy
  2010.             shall use the default community string in the
  2011.             snmpSecurityParameter object instance contained by the
  2012.             cmipsnmpProxyAgent.  If no default applies, the operation
  2013.             shall be rejected by the proxy with an access denied error.
  2014.  
  2015.             Chang             Expires November 29, 1993          Page 29
  2016.  
  2017.  
  2018.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2019.  
  2020.  
  2021.  
  2022.             4.3.3  Internet Agent Transport Address
  2023.  
  2024.             For SNMPv2, the proxy uses the value of the destination party
  2025.             identifier, derived according to the procedures in 4.3.1, to
  2026.             look up the transport address in an entry of the partyTable.
  2027.  
  2028.             For SNMPv1, the Internet agent transport address shall be
  2029.             derived from the associated transport address in the table of
  2030.             cmipsnmpProxyAgent entries.  The cmipsnmpProxyAgent is the one
  2031.             which has the same systemId as the attribute value within the
  2032.             RDN of the system object provided in the AETitle (if local
  2033.             name is used), or the CMIS managed object instance parameter.
  2034.  
  2035.             4.3.4  SNMP Variable-Bindings Parameter
  2036.  
  2037.             The SNMP variable-bindings list parameter contains a sequence
  2038.             of varBinds, each of which is an (Internet object name, value)
  2039.             pair.
  2040.  
  2041.             For CMIS M-CREATE, M-SET, M-DELETE requests, the Internet
  2042.             object name shall be derived from the DN contained in the CMIP
  2043.             managed object instance parameter, and the attribute
  2044.             identifier provided in the CMIS request attributeIdList or
  2045.             attributeList parameter, using the algorithm defined in
  2046.             [IIMCIMIBTRANS] clause 2.3.1.
  2047.  
  2048.             For M-CREATE and M-SET requests, the Internet object value
  2049.             shall be assigned the attribute value associated with the
  2050.             attributeId from which the Internet object name was derived.
  2051.  
  2052.             For M-GET requests, it is recommended the Internet object
  2053.             value is NULL.
  2054.  
  2055.             For M-DELETE requests, the proxy shall use the delete
  2056.             information as described in the NAME BINDING template behavior
  2057.             defined for the object class. Within the BEHAVIOUR text, the
  2058.             CREATEDELETEATT specifies the Internet object name and
  2059.             CREATEDELETEVALUE specifies the Internet object value which
  2060.             signifies row deletion.
  2061.  
  2062.             4.4  Derivation Of CMIS Parameters
  2063.  
  2064.             Given the rules specified in this section, and knowledge of
  2065.             the IIMC containment hierarchy (name bindings), the ISO/CCITT
  2066.             {classOID}, {attributeOID}, and distinguished name can be
  2067.             derived from Internet names and the agent identifier.
  2068.  
  2069.             The iimcAutoTrans OID is known to the proxy.  It is defined
  2070.             in [IIMCIMIBTRANS].
  2071.  
  2072.             4.4.1  Attribute Id Parameter
  2073.  
  2074.  
  2075.  
  2076.             Chang             Expires November 29, 1993          Page 30
  2077.  
  2078.  
  2079.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2080.  
  2081.  
  2082.             Using knowledge of the Internet name structure, and knowledge
  2083.             of valid <internetEntityId>(a) values known to the proxy, the
  2084.             <internetEntityId>(a) and <internet instanceId> may be
  2085.             extracted from the Internet object name.
  2086.  
  2087.             The extraction process is not possible if the valid
  2088.             <internetEntityId>(a) value is not known to the proxy.  In
  2089.             that case ,the translation process  cannot be performed.
  2090.  
  2091.             The ISO/CCITT attribute identifier is formed as:
  2092.  
  2093.                  {iimcAutoTrans <internetEntityId>(a)}
  2094.  
  2095.             4.4.2  Managed Object Class Parameter
  2096.  
  2097.             In CMIS response, the managed object class parameter can be
  2098.             derived from the proxy's retained information.
  2099.  
  2100.             If actual class is used in the incoming CMIS request, the
  2101.             proxy must derive the object class parameter from the DN in
  2102.             the original CMIS request.  The proxy shall compare the
  2103.             attribute value of the last RDN in the CMIS request with all
  2104.             the known ISO/CCITT object classes.  The proxy shall assume
  2105.             that object class that has the longest match with the
  2106.             attribute value of the last RDN is the actual object class.
  2107.             If the CMIS request is a scoped request, the object class
  2108.             shall be derived from the retained information.  If the
  2109.             Distinguished name is an empty set of RDN, "CCITT Rec. X.660 |
  2110.             ISO/IEC 9834-1 : 1992": root is assumed as the object class.
  2111.  
  2112.             4.4.3  Managed Object Instance Parameter
  2113.  
  2114.             The managed object instance value (the base managed object's
  2115.             DN) is retained by the proxy during processing of the CMIS
  2116.             request.  However, for DNs other than the base managed object
  2117.             instance, the following steps shall be taken to derive the
  2118.             subordinate RDNs.
  2119.  
  2120.             i)   The value of the internetClassId naming attribute
  2121.                  associated with the object class, may be formed as:
  2122.  
  2123.             {iimcAutoTrans <internetEntityId>(c) <internet instanceId>}
  2124.  
  2125.             ii)  The internetClassId value, and the internetClass OID are
  2126.                  used to form the final RDN for the object's DN. Assume
  2127.                  that the object class was able to be determined using the
  2128.                  procedures of 4.4.2.  The sequence of other RDNs for the
  2129.                  DN may be determined as follows.
  2130.  
  2131.                  Use knowledge of the containment hierarchy defined by
  2132.                  name bindings, and the Internet agent's identifier. The
  2133.                  object class's name binding may be identified as that
  2134.                  name binding which contains the object class OID as its
  2135.                  final component, in accordance with the name binding
  2136.  
  2137.             Chang             Expires November 29, 1993          Page 31
  2138.  
  2139.  
  2140.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2141.  
  2142.  
  2143.                  registration procedures defined in [IIMCIMIBTRANS] clause
  2144.                  2.1.3.  Use the superior/subordinate relationships in the
  2145.                  name bindings to build the DN in reverse, beginning with
  2146.                  the final RDN and ending with the RDN for the ISO/CCITT
  2147.                  system object. For superior classes that can have only a
  2148.                  single instance, the internetClassId value for the object
  2149.                  is created by appending the integer zero to the class
  2150.                  OID.  The agent's identifier is used as the value for the
  2151.                  RDN of the ISO/CCITT system object.
  2152.  
  2153.                  One case exists for MIBs derived according to
  2154.                  [IIMCIMIBTRANS] where it is possible for the superior
  2155.                  object class to have multiple instances.  This may occur
  2156.                  when the subordinate object class was translated as the
  2157.                  result of an SNMPv2 AUGMENTS clause and the superior
  2158.                  object class is a table entry.  In that case, the
  2159.                  instance of the superior object class is identified by
  2160.                  the same instanceId used to identify the subordinate
  2161.                  object, prepended with the superior object's class OID.
  2162.  
  2163.                  If the Internet agent's address  cannot be determined,
  2164.                  then it may not be possible to associate a notification
  2165.                  with a specific agent.  This may be a problem if multiple
  2166.                  Internet agents are associated with the same network
  2167.                  address.  In such cases, the DN for the cmipsnmpProxy
  2168.                  object instance shall be used as the object instance.
  2169.  
  2170.             4.4.4  EventId Parameter
  2171.  
  2172.             The eventId parameter shall be the OID assigned the
  2173.             internetAlarm as defined in [IIMCIMIBTRANS].
  2174.  
  2175.             4.4.5  InternetAlarm ProbableCause Parameter
  2176.  
  2177.             The internetAlarm notification probableCause parameter shall
  2178.             be derived as defined in [IIMCIMIBTRANS] clause 3.2.5.
  2179.  
  2180.             Internet traps/notifications are registered using the OID
  2181.             corresponding to the value of the Internet snmpTrapOID object
  2182.             defined in [RFC1450].
  2183.  
  2184.             For SNMPv1 Trap PDUs, the snmpTrapOID is derived as stated in
  2185.             the SNMPv1/SNMPv2 Coexistence document [RFC1452] clause 4.1.2
  2186.             (2).  That definition is repeated below:
  2187.  
  2188.             "... if the value of the generic-trap field is
  2189.             'enterpriseSpecific' then the value used is the concatenation
  2190.             of the enterprise field from the trap PDU with additional sub-
  2191.             identifiers, '0', and the value of the specific-trap field."
  2192.  
  2193.             For notifications defined according to the SNMPv2 SMI, the
  2194.             probableCause is determined by either the snmpTrapOID.0 or
  2195.             snmpEventID.i, which is contained in the second variable
  2196.             binding of the Trap or InformRequest, respectively.
  2197.  
  2198.             Chang             Expires November 29, 1993          Page 32
  2199.  
  2200.  
  2201.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2202.  
  2203.  
  2204.  
  2205.             Only the "globalValue" (i.e., OID form) of the probableCause
  2206.             syntax shall be used.
  2207.  
  2208.  
  2209.             4.4.6  InternetAlarm AttributeIdentifier List
  2210.  
  2211.             The following process shall be followed for each variable in
  2212.             the variable-bindings, excluding the first two variable-
  2213.             bindings.
  2214.  
  2215.             The name portion of the variable binding shall be converted to
  2216.             an ISO/CCITT attributeId using the procedure specified in
  2217.             section 4.4.1. The converted ISO/CCITT attributeId shall be
  2218.             placed in the attributeIdList.
  2219.  
  2220.             4.4.7  InternetAlarm ObjectInstanceList
  2221.  
  2222.             The following process shall be followed for each variable in
  2223.             the variable-bindings, excluding the first two variable-
  2224.             bindings.
  2225.  
  2226.             The name portion of the variable binding shall be converted to
  2227.             an ISO/CCITT object instance name using the procedures
  2228.             specified in section 4.4.3. The converted ISO/CCITT object
  2229.             instance name shall be placed in the object instance list.
  2230.  
  2231.             If the proxy  cannot determine the object instance name (e.g.,
  2232.             because the Internet agent's identifier  cannot be
  2233.             determined), then the objectInstanceList parameter shall not
  2234.             be included in the internetAlarm.
  2235.  
  2236.             4.4.8  InternetAlarm InternetTrapInfo Parameter
  2237.  
  2238.             The following process shall be followed for each variable in
  2239.             the variable-bindings.
  2240.  
  2241.             The name portion of the variable binding shall be converted to
  2242.             an ISO/CCITT object instance name using the procedures
  2243.             specified in section 4.4.3. The converted ISO/CCITT object
  2244.             instance name shall be placed in the objectInstance field of
  2245.             the internetTrapInfo parameter.
  2246.  
  2247.             If the Internet agent's identifier  cannot be determined, or
  2248.             the <internetEntityId>(a) is unknown to the proxy, then the
  2249.             object instance name  cannot be determined and the
  2250.             objectInstance field shall not be included in the
  2251.             internetTrapInfo parameter, but shall be included in the
  2252.             unknownVarBindList parameter.
  2253.  
  2254.             4.4.9  InternetAlarm UnknownVarBindList Parameter
  2255.  
  2256.             If the proxy  cannot determine the attributeId for a variable
  2257.             binding (i.e., because the <internetEntityId>(a)portion of the
  2258.  
  2259.             Chang             Expires November 29, 1993          Page 33
  2260.  
  2261.  
  2262.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2263.  
  2264.  
  2265.             Internet object name is not known to the proxy), then that
  2266.             variable binding shall be included in the unknownVarBindList
  2267.             parameter.
  2268.  
  2269.             4.4.10  InternetAlarm PerceivedSeverity Parameter
  2270.  
  2271.             The proxy  cannot determine the perceivedSeverity for the
  2272.             translated SNMP Trap without specific knowledge of the Trap.
  2273.             Therefore, the proxy always assumes "indeterminate" for all
  2274.             the CMIS M-EVENT-REPORTs generated as a result of SNMP Traps.
  2275.  
  2276.             However, a proxy can build in some local knowledge of the SNMP
  2277.             Traps and assign different perceivedSeverity values based on
  2278.             its local knowledge. Such local knowledge is not within the
  2279.             scope of this document.
  2280.  
  2281.             4.4.11  InternetAlarm TransportDomain Parameter
  2282.  
  2283.             For SNMPv2 Traps, the transportDomain parameter may be
  2284.             determined by using the one of the party identifier parameters
  2285.             associated with the Trap. The partyEntry object identified by
  2286.             the party identifier contains the partyDomain attribute.
  2287.  
  2288.             For either SNMPv1, or SNMPv2 Traps, knowledge of the transport
  2289.             protocol used may be provided to the proxy. Alternatively, if
  2290.             the transport address can be determined, the proxy can
  2291.             determine the transport protocol from the format of the
  2292.             address.  The proxy may then be able to determine the
  2293.             appropriate transportDomain value from local knowledge of the
  2294.             OIDs registered for different transport domains.
  2295.  
  2296.             4.4.12  InternetAlarm TransportAddress Parameter
  2297.  
  2298.             See section 4.3.3 for possible ways to determine the transport
  2299.             address.
  2300.  
  2301.             4.4.13  InternetAlarm AccessControl Parameter
  2302.  
  2303.             The access control parameter shall be assigned the community
  2304.             string or party identifiers associated with the SNMP Trap.
  2305.  
  2306.             5  Error Message Translation
  2307.  
  2308.             5.1  Translating SNMP Error Messages
  2309.  
  2310.             SNMP error responses received by the ISO/Internet proxy are
  2311.             translated to CMIS error responses and sent back to the
  2312.             ISO/CCITT manager. The following sections provides a mapping
  2313.             for SNMP error messages to CMIS error responses.
  2314.  
  2315.             5.1.1  tooBig
  2316.  
  2317.             If the SNMP error "tooBig" is received, the ISO/Internet proxy
  2318.             should try to break the SNMP Request into smaller requests and
  2319.  
  2320.             Chang             Expires November 29, 1993          Page 34
  2321.  
  2322.  
  2323.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2324.  
  2325.  
  2326.             resend the requests.  If it is not feasible to break the
  2327.             request to any smaller request, and this error occurs, the
  2328.             CMIS error response "Complexity limitation" should be returned
  2329.             to the ISO/CCITT manager.
  2330.  
  2331.             5.1.2  noSuchName
  2332.  
  2333.             If the SNMP error "noSuchName" occurs when an attribute is
  2334.             queried as part of a CMIS Filter evaluation, then the
  2335.             filterItem will be evaluated as FALSE.
  2336.  
  2337.             In order to check if an object exists, all the object class's
  2338.             attributes should be queried until at least one attribute's
  2339.             existence is verified. If none of the attributes exist, and
  2340.             the object is the base managed object, then a
  2341.             "NoSuchObjectInstance" CMIS error response should be returned.
  2342.  
  2343.             If the object exists and the SNMP "noSuchName" error occurs
  2344.             when attempting to read or modify an attribute, a CMIS "No
  2345.             Such Attribute" error response should be returned to the
  2346.             ISO/CCITT manager.
  2347.  
  2348.             If the ISO/Internet proxy maintains correct schema information
  2349.             and the Internet agent is a conforming agent, an Internet
  2350.             object's attributes should either all exist or none exist. In
  2351.             order to make the ISO/Internet proxy a practical solution, the
  2352.             preceding error situation is included in order to deal with a
  2353.             non-conforming Internet agent.
  2354.  
  2355.             5.1.3  badValue
  2356.  
  2357.             If the SNMP error "badValue" is returned for an SNMP Get
  2358.             Request, then a "processing failure" CMIS error response
  2359.             should be returned to the ISO/CCITT manager. In the
  2360.             ProcessingFailure parameter of the CMIS error response, the
  2361.             errorId should be "snmpBadValue", and the errorInfo should be
  2362.             the variable binding identified by the error-index.
  2363.  
  2364.             If the badValue error occurs during an SNMP Set Request to
  2365.             fulfill a CMIS M-DELETE request, a "processing failure" CMIS
  2366.             error response should be returned.  In the ProcessingFailure
  2367.             parameter, the errorId should be " cannotDelete" and the
  2368.             errorInfo should be the variable binding that is identified by
  2369.             the error-index.
  2370.  
  2371.             5.1.4  readOnly
  2372.  
  2373.             The proxy should never receive an SNMP readOnly error from an
  2374.             SNMPv1 agent.  If this error is received, a "processing
  2375.             failure" CMIS error response should be returned to the
  2376.             ISO/CCITT manager. In the processingFailure parameter, the
  2377.             errorId should be "snmpReadOnly" and the errorInfo should be
  2378.             the variable binding that is identified by the error-index.
  2379.  
  2380.  
  2381.             Chang             Expires November 29, 1993          Page 35
  2382.  
  2383.  
  2384.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2385.  
  2386.  
  2387.             For SNMPv2, if the SNMP error "readOnly" occurs when checking
  2388.             for the existence of a base object, a "processingfailure" CMIS
  2389.             error response should be returned to the ISO/CCITT  manager.
  2390.             In the ProcessingFailure parameter of the CMIS error response,
  2391.             the errorId should be "snmpReadOnly", and the errorInfo should
  2392.             be the variable binding identified by the error-index.  If the
  2393.             error occurs when deleting the object, then the
  2394.             deleteErrorInfo field in the response shall be set to
  2395.             "accessDenied".
  2396.  
  2397.             5.1.5  genErr
  2398.  
  2399.             If the SNMP error "genErr" occurs, the "ProcessingFailure"
  2400.             CMIS error response should be returned to ISO/CCITT manager.
  2401.             If the entry exists, scoping continues; otherwise, scoping
  2402.             terminates. In the ProcessingFailure parameter of the CMIS
  2403.             error response, the errorId should be "snmpGenErr".
  2404.  
  2405.             There are additional error messages in SNMPv2. Most of the
  2406.             errors are defined for the Set Request. Since a Set Request
  2407.             may be originated when processing a CMIP M-SET request, an M-
  2408.             CREATE request or an M-DELETE request, the proxy must ensure
  2409.             each error code is translated to the one which is most
  2410.             compatible with the original CMIS request. In addition, the
  2411.             proxy must ensure the selected error value is compatible with
  2412.             the use of other parameters such as scoping, filtering,
  2413.             synchronization and multiple linked reply.
  2414.  
  2415.             5.1.6  noAccess
  2416.  
  2417.             This error indicates the variable binding's name specifies a
  2418.             variable which is not accessible by an SNMP Set Request.  This
  2419.             error should be mapped to the CMIS "accessDenied" error.
  2420.  
  2421.             5.1.7  wrongType
  2422.  
  2423.             This error indicates the variable binding's value field of an
  2424.             SNMP Set Request specified a type which is inconsistent with
  2425.             that required for the variable. This error may be mapped to
  2426.             the CMIS "invalidAttributeValue" error.
  2427.  
  2428.             5.1.8  wrongLength
  2429.  
  2430.             This error indicates the variable binding's value field of an
  2431.             SNMP Set Request specifies, according to the ASN.1 language, a
  2432.             length which is inconsistent with that required for the
  2433.             variable.  If the original CMIS request is M-CREATE or M-SET,
  2434.             the CMIS error "InvalidAttributeValue" shall be returned. If
  2435.             the original CMIS request is M-DELETE, the CMIS "processing
  2436.             failure" error shall be returned.
  2437.  
  2438.             5.1.9  wrongEncoding
  2439.  
  2440.  
  2441.  
  2442.             Chang             Expires November 29, 1993          Page 36
  2443.  
  2444.  
  2445.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2446.  
  2447.  
  2448.             This error is used to indicate the variable binding's value
  2449.             field of an SNMP Set Request contains an ASN.1 encoding which
  2450.             is inconsistent with that field's ASN.1 tag. This error should
  2451.             be mapped to the CMIS "processingFailure" error.
  2452.  
  2453.             5.1.10  wrongValue
  2454.  
  2455.             This error indicates the variable binding's value field in an
  2456.             SNMP Set Request specifies a value which could under no
  2457.             circumstances be assigned to the variable. This error should
  2458.             be mapped to the CMIS "invalidAttributeValue" error.
  2459.  
  2460.             5.1.11  noCreation
  2461.  
  2462.             This error is generated when an SNMP Set Request variable
  2463.             binding name specified a variable which does not exist and
  2464.             could not ever be created. This error should be mapped to the
  2465.             CMIS "invalidObjectInstance" error.
  2466.  
  2467.             5.1.12  inconsistentValue
  2468.  
  2469.             This error indicates that an SNMP Set Request variable binding
  2470.             value field specified a value that could under other
  2471.             circumstances be assigned to the variable, but is presently
  2472.             inconsistent. If the SNMP Set Request was generated as a
  2473.             result of a CMIS M-CREATE or M-SET operation, the error should
  2474.             be mapped to the CMIS "invalidAttributeValue" error.
  2475.  
  2476.             If the SNMP Set Request was generated as a result of CMIS M-
  2477.             DELETE operation, the error may be mapped to the CMIS
  2478.             "processingfailure" error.
  2479.  
  2480.             5.1.13  resourceUnavailable
  2481.  
  2482.             This error indicates that the assignment of a value by an SNMP
  2483.             Set Request requires the allocation of a resource which is
  2484.             presently unavailable. This error may be mapped to the CMIS
  2485.             "resourceLimitation" error.
  2486.  
  2487.             5.1.14  commitFailed
  2488.  
  2489.             When performing an SNMP Set Request, the Internet agent must
  2490.             ensure all variable assignments occur atomically. If any of
  2491.             the assignments fail, an SNMP "commitFailed" error is
  2492.             returned. If the original CMIS request is a "best effort"
  2493.             request, the proxy should either retry the failed variable
  2494.             assignments by sending multiple SNMP Set Requests, or return a
  2495.             CMIS setListError with a "processingfailure" error.
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.             Chang             Expires November 29, 1993          Page 37
  2504.  
  2505.  
  2506.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2507.  
  2508.  
  2509.             5.1.15  undoFailed
  2510.  
  2511.             When performing an SNMP Set Request, the Internet agent must
  2512.             ensure all variable assignments occur atomically. If any of
  2513.             the assignments fail, the agent should undo all the
  2514.             assignments. An SNMP "undoFailed" error is returned when the
  2515.             agent  cannot undo all the assignments.  CMIS does not have
  2516.             any error value equivalent to this. The CMIS "processing
  2517.             failure" error must be returned.
  2518.  
  2519.             5.1.16  authorizationError
  2520.  
  2521.             This error indicates that an SNMP Request has been discarded
  2522.             because the authorization context used in the request does not
  2523.             allow the PDU type. This error is mapped to the CMIS
  2524.             "accessDenied" error.
  2525.  
  2526.             5.1.17  notWritable
  2527.  
  2528.             The "notWritable" error is used to indicate that an SNMP Set
  2529.             Request is trying to modify the value of a variable which is
  2530.             not modifiable, no matter what new value is specified. This
  2531.             error shall be mapped to the CMIS "invalidOperation" error.
  2532.  
  2533.  
  2534.             5.2  CMIS Processing Failure
  2535.  
  2536.             There are many error scenarios in which the error  cannot be
  2537.             mapped to a specific CMIS error.  In this case, the
  2538.             "processing failure" CMIS error response should be reported
  2539.             back to the ISO/CCITT manager. In order to provide the
  2540.             ISO/CCITT manager with a better description of the error, the
  2541.             specificErrorInfo field in ProcessingFailure is used to record
  2542.             the cause of the problem.
  2543.  
  2544.             The following object identifiers are defined:
  2545.  
  2546.                  snmpTooBig     OBJECT IDENTIFIER ::= { iimcErrors 0 }
  2547.                  snmpBadValue   OBJECT IDENTIFIER ::= { iimcErrors 1 }
  2548.                  snmpReadOnly   OBJECT IDENTIFIER ::= { iimcErrors 2 }
  2549.                  snmpGenErr     OBJECT IDENTIFIER ::= { iimcErrors 3 }
  2550.                  noResponse     OBJECT IDENTIFIER ::= { iimcErrors 4 }
  2551.                  cannotDelete   OBJECT IDENTIFIER ::= { iimcErrors 5 }
  2552.                  notImplemented OBJECT IDENTIFIER ::= { iimcErrors 6 }
  2553.                  wrongLength    OBJECT IDENTIFIER ::= { iimcErrors 7 }
  2554.                  wrongEncoding  OBJECT IDENTIFIER ::= { iimcErrors 8 }
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.             Chang             Expires November 29, 1993          Page 38
  2565.  
  2566.  
  2567.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2568.  
  2569.  
  2570.             where the errInfo parameter depends on the value of errorId:
  2571.  
  2572.                  errorId        errInfo
  2573.                  -------        -------
  2574.                  snmpTooBig     VarBindList
  2575.                  snmpBadValue   VarBind
  2576.                  snmpReadOnly   OBJECT IDENTIFIER
  2577.                  cannotDelete   VarBind
  2578.                  notImplemented INTEGER {
  2579.                                 transport(0),
  2580.                                 authenticationProtocol(1),
  2581.                                 privacyProtocol(2)
  2582.                                 }
  2583.  
  2584.  
  2585.             6  ISO/CCITT Systems Management Functions
  2586.  
  2587.             ISO/CCITT systems management standards include a set of
  2588.             Systems Management Function specifications. An ISO/Internet
  2589.             proxy may choose to support some or all of these systems
  2590.             management functions. This section provides some of the
  2591.             modeling approaches which may be used in supporting ISO/CCITT
  2592.             systems management functions.
  2593.  
  2594.  
  2595.             6.1  Event Report Management Function
  2596.  
  2597.             The ISO/CCITT Event Report Management Function [ISO10164-5]
  2598.             defines an Event Forwarding Discriminator (EFD) managed object
  2599.             which allows an ISO/CCITT manager to control the forwarding
  2600.             and processing of potential event reports by an ISO/CCITT
  2601.             agent. The Event Report Management Function maybe supported by
  2602.             an ISO/Internet proxy to allow the ISO/CCITT manager to
  2603.             control where and how Internet Traps and Inform Requests may
  2604.             be forwarded.
  2605.  
  2606.             Since all Internet Traps and Inform Requests are translated by
  2607.             the proxy and are forwarded to their destinations by the
  2608.             proxy, EFD managed objects are best supported by the proxy as
  2609.             local objects. Upon receiving a CMIS M-CREATE request for an
  2610.             EFD, the proxy creates the EFD object instance according to
  2611.             the specified name binding. Once created, the EFD is used by
  2612.             the proxy to determine which CMIS M-EVENT-REPORTs are to be
  2613.             forwarded to a particular destination during a specified time
  2614.             period.
  2615.  
  2616.  
  2617.             6.2  Log Control Function
  2618.  
  2619.             The ISO/CCITT Log Control Function [ISO10164-6] defines a Log
  2620.             managed object which allows control and monitoring of a log
  2621.             and the retrieval of its log records. If the Log managed
  2622.             object is supported, Internet Traps and Inform Requests may be
  2623.             logged according to a predefined criteria.
  2624.  
  2625.             Chang             Expires November 29, 1993          Page 39
  2626.  
  2627.  
  2628.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2629.  
  2630.  
  2631.  
  2632.             Since only notifications are logged and these are constructed
  2633.             by the proxy, the Log managed object can be defined as a local
  2634.             object of a proxy. Upon receiving a CMIS M-CREATE request for
  2635.             a Log object, the proxy creates the Log instance according to
  2636.             the specified name binding. Once created, the Log is used by
  2637.             the proxy to process the received Traps and Inform Requests
  2638.             (and local notifications) for logging.
  2639.  
  2640.             An InternetAlarmRecord managed object class is defined in
  2641.             [IIMCIMIBTRANS].
  2642.  
  2643.  
  2644.             6.3  Scope of the EFD and Log
  2645.  
  2646.             EFD and Log objects can be created under either the remote
  2647.             system or the proxy system objects.  EFD and Log object
  2648.             instance behaviour is different depending on its position in
  2649.             the containment tree.
  2650.  
  2651.             "containment object"
  2652.                    |
  2653.                    +-remote system
  2654.                    |       |- EFD (for remote events)
  2655.                    |       |- Log - Log Record (for remote events)
  2656.                    |       |
  2657.                    |       |_ translated MIB group class subtree(s)
  2658.                    |
  2659.                    +-proxy system -- cmipsnmpProxy -cmipsnmpProxyAgent
  2660.                            |
  2661.                            |- EFD (for proxy events)
  2662.                            |- Log - Log Record (for proxy events)
  2663.                            |
  2664.                            |- EFD (for all events)
  2665.                            |- Log - Log Record (for all events)
  2666.  
  2667.             EFD and Log objects contained by the remote system object
  2668.             shall process only those events generated by the objects
  2669.             known to each Internet agent (i.e., objects contained by the
  2670.             same remote system object).
  2671.  
  2672.             EFD and Log objects contained by a proxy system object with
  2673.             the instance name "ProxyOnly" shall process only those events
  2674.             emitted from the object instances contained by the proxy
  2675.             system.  Any other EFD or Log object contained by the proxy
  2676.             system shall apply to any event (including all events
  2677.             generated by any object).  If an EFD or Log is created under
  2678.             the proxy system using automatic instance naming, the proxy
  2679.             shall choose a name other than the name "ProxyOnly".
  2680.  
  2681.  
  2682.             7  ISO/CCITT-Internet Proxy MIB
  2683.  
  2684.  
  2685.  
  2686.             Chang             Expires November 29, 1993          Page 40
  2687.  
  2688.  
  2689.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2690.  
  2691.  
  2692.             The ISO/CCITT-Internet Proxy MIB defines a set of objects for
  2693.             specifying the information that is needed for both community-
  2694.             based and party-based SNMP management on a per Internet agent
  2695.             basis. The containment hierarchy and other introductory
  2696.             information regarding this Proxy MIB can be found in section
  2697.             2.3.
  2698.  
  2699.             The GDMO templates and ASN.1 modules are included here in one
  2700.             section to facilitate automated processing.  Comments and
  2701.             subsection headers are included in the form of ASN.1 comments,
  2702.             i.e., preceded by "--".
  2703.  
  2704.             This document (IIMCPROXY) is allocated the following
  2705.             registration identifier for purposes of referencing material
  2706.             contained herein.
  2707.  
  2708.             iimcIIMCProxy OBJECT IDENTIFIER ::= {iimcManagementDocMan 3}
  2709.  
  2710.  
  2711.             7.1  Proxy MIB GDMO Templates
  2712.  
  2713.  
  2714.             -- 7.1.1  Proxy MIB Managed Object Classes
  2715.  
  2716.  
  2717.             cmipsnmpProxyAgent MANAGED OBJECT CLASS
  2718.                DERIVED FROM
  2719.                  "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
  2720.                CHARACTERIZED BY
  2721.                  cmipsnmpProxyAgentPkg PACKAGE
  2722.                  BEHAVIOUR cmipsnmpProxyAgentPkgBehaviour BEHAVIOUR
  2723.                  DEFINED AS
  2724.                  !This managed object class is used to represent an
  2725.                  Internet agent in the proxy MIB.  Each agent that
  2726.                  the proxy manages is represented by an instance of
  2727.                  this object class.
  2728.  
  2729.                  The cmipsnmpProxyAgentId attribute contains the
  2730.                  administratively-assigned name of the managed
  2731.                  system that contains the Internet agent.  Usually
  2732.                  this is an Internet Domain Name.  This attribute
  2733.                  value shall be determined by the manager when the
  2734.                  object is created.
  2735.  
  2736.                  The managementProtocol attribute specifies the
  2737.                  Internet management protocol used by the proxy to
  2738.                  manage devices.  It shall be the OID indicating
  2739.                  SNMPv1, SNMPv2, or some other protocol. This
  2740.                  attribute is assigned a value (an OID) by the
  2741.                  manager that is appropriate for the Internet agent.
  2742.  
  2743.                  The supportedMIBs attribute identifies the set of
  2744.                  GDMO documents that describe the MIBs that the
  2745.                  Internet agent supports. The ISO/CCITT manager may
  2746.  
  2747.             Chang             Expires November 29, 1993          Page 41
  2748.  
  2749.  
  2750.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2751.  
  2752.  
  2753.                  add elements to or remove elements from this
  2754.                  attribute.
  2755.  
  2756.                  Two object instances shall be created by the proxy
  2757.                  automatically when an instance of the
  2758.                  cmipsnmpProxyAgent class is created. One is the
  2759.                  system object that represents the Internet
  2760.                  agent. The other is the "OP1 Library Vol.
  2761.                  4":capabilityObject as defined by [NMF006].
  2762.  
  2763.                  The accessControlEnforcement attribute indicates
  2764.                  where access control is applied: at the Internet
  2765.                  agent, the ISO/Internet proxy, or both.
  2766.  
  2767.                  The accessControlMechanism attribute indicates
  2768.                  whether no access control, Internet access control
  2769.                  as specified in [RFC1446], or ISO/CCITT access
  2770.                  control as specified in [ISO10164-9] is to be used.
  2771.                  The default is no access control.
  2772.  
  2773.                  The administrativeState attribute is used to suspend
  2774.                  or resume the proxy activity relative to the Internet
  2775.                  agent. It is the same as the administrativeState
  2776.                  attribute defined in [ISO10165-2].
  2777.  
  2778.                  The "unlocked" state means that proxy must continue
  2779.                  to perform, or resume performing, proxy activities
  2780.                  on behalf of the Internet agent.
  2781.  
  2782.                  The "locked" state means that the proxy must not
  2783.                  perform, or suspend performing, proxy activities on
  2784.                  behalf of the Internet agent.
  2785.                  !;;
  2786.  
  2787.                ATTRIBUTES
  2788.                  cmipsnmpProxyAgentId GET,
  2789.                  {iimcManagementDoc 1}:transportAddress GET-REPLACE,
  2790.                  managementProtocol  REPLACE-WITH-DEFAULT GET,
  2791.                  supportedMIBs       GET-REPLACE ADD-REMOVE,
  2792.                  accessControlEnforcement GET-REPLACE,
  2793.                  accessControlMechanism DEFAULT VALUE
  2794.                                 IimcProxyASN1.noAccessControl
  2795.                                 GET-REPLACE,
  2796.                  "Rec. X.721 | ISO/IEC 10165-2 : 1992":
  2797.                  administrativeState GET-REPLACE;;;
  2798.                REGISTERED AS  { iimcProxyObjectClass 1 };
  2799.  
  2800.  
  2801.             cmipsnmpProxy MANAGED OBJECT CLASS
  2802.                DERIVED FROM
  2803.                  "Rec. X.721 | ISO/IEC 10165-2 : 1992" : top;
  2804.                CHARACTERIZED BY
  2805.                  cmipsnmpProxyPkg PACKAGE
  2806.                  BEHAVIOUR
  2807.  
  2808.             Chang             Expires November 29, 1993          Page 42
  2809.  
  2810.  
  2811.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2812.  
  2813.  
  2814.                  cmipsnmpProxyPkgBehaviour BEHAVIOUR
  2815.                  DEFINED AS
  2816.                  !This managed object class is used to contain
  2817.                  objects that represent an Internet agent in the
  2818.                  proxy MIB.
  2819.  
  2820.                  The internetAlarm shall be emitted by this object
  2821.                  class when the application level source of the SNMP
  2822.                  Trap or Inform Request cannot be determined. The
  2823.                  address field of the internetAlarm shall be set to
  2824.                  the network address associated with the SNMP Trap
  2825.                  or Inform Request.!;;
  2826.                ATTRIBUTES
  2827.                  {iimcManagementDocMan 1}:internetClassId GET;
  2828.                NOTIFICATIONS
  2829.                  {iimcManagementDocMan 1}:internetAlarm;;;
  2830.                REGISTERED AS  {iimcProxyObjectClass 2};
  2831.  
  2832.  
  2833.             snmpSecurityParameter MANAGED OBJECT CLASS
  2834.                DERIVED FROM
  2835.                  "Rec. X.721 | ISO/IEC 10165-2 : 1992" : top;
  2836.                CHARACTERIZED BY
  2837.                  defaultSecurityParameterPkg PACKAGE
  2838.                  BEHAVIOUR
  2839.                  defaultSecurityParameterPkgBehaviour BEHAVIOUR
  2840.                  DEFINED AS
  2841.                  ! This object instance contains the default security
  2842.                  parameter that is used only when such AccessControl
  2843.                  field is not received during association
  2844.                  establishment.!;;
  2845.                ATTRIBUTES
  2846.                  "iimcManagementDoc 1":internetClassId   GET,
  2847.                  snmpSecurity             GET-REPLACE
  2848.                                           ADD-REMOVE ;;;
  2849.                REGISTERED AS  {iimcProxyObjectClass 3};
  2850.  
  2851.  
  2852.             --  7.1.2  Proxy MIB Attributes
  2853.  
  2854.  
  2855.             accessControlEnforcement ATTRIBUTE
  2856.                WITH ATTRIBUTE SYNTAX
  2857.                  IimcProxyASN1.AccessControlEnforcement;
  2858.                MATCHES FOR EQUALITY, ORDERING;
  2859.                BEHAVIOUR accessControlEnforcementBehaviour BEHAVIOUR
  2860.                  DEFINED AS
  2861.                  !The accessControlEnforcement attribute indicates
  2862.                  where access control is applied: Internet agent,
  2863.                  proxy, or both.!;;
  2864.                REGISTERED AS {iimcProxyAttributeID 1 };
  2865.  
  2866.  
  2867.             accessControlMechanism ATTRIBUTE
  2868.  
  2869.             Chang             Expires November 29, 1993          Page 43
  2870.  
  2871.  
  2872.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2873.  
  2874.  
  2875.                WITH ATTRIBUTE SYNTAX
  2876.                  IimcProxyASN1.AccessControlMechanism;
  2877.                MATCHES FOR EQUALITY, ORDERING;
  2878.                BEHAVIOUR accessControlMechanismBehaviour BEHAVIOUR
  2879.                  DEFINED AS
  2880.                  !The accessControlMechanism attribute indicates
  2881.                  which access control is to be applied at the proxy
  2882.                  device.  The mechanism may be no access control,
  2883.                  the internet access control as defined in
  2884.                  [RFC1446] or one of the ISO access control
  2885.                  mechanisms as defined in [ISO10164-9].!;;
  2886.                REGISTERED AS {iimcProxyAttributeID 2 };
  2887.  
  2888.  
  2889.             cmipsnmpProxyAgentId ATTRIBUTE
  2890.                WITH ATTRIBUTE SYNTAX
  2891.                  IimcProxyASN1.DistinguishedName;
  2892.                MATCHES FOR EQUALITY;
  2893.                BEHAVIOUR cmipsnmpProxyAgentIdBehaviour BEHAVIOUR
  2894.                  DEFINED AS
  2895.                  !This is the naming attribute for the
  2896.                  cmipsnmpProxyAgent object class.  This
  2897.                  attribute will name the system which
  2898.                  represents the proxied device.!;;
  2899.                REGISTERED AS {iimcProxyAttributeID 3 };
  2900.  
  2901.  
  2902.             managementProtocol ATTRIBUTE
  2903.                WITH ATTRIBUTE SYNTAX
  2904.                  IimcProxyASN1.ObjectIdentifier;
  2905.                MATCHES FOR EQUALITY, ORDERING;
  2906.                BEHAVIOUR managementProtocolBehaviour BEHAVIOUR
  2907.                  DEFINED AS
  2908.                  !This attributes specifies the Internet management
  2909.                  protocol used for proxy to managed devices.  It
  2910.                  shall have a value of either SNMPv1 or SNMPv2.!;;
  2911.                REGISTERED AS {iimcProxyAttributeID 4 };
  2912.  
  2913.  
  2914.             supportedMIBs ATTRIBUTE
  2915.                WITH ATTRIBUTE SYNTAX
  2916.                  IimcProxyASN1.SupportedMIBs;
  2917.                MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
  2918.                BEHAVIOUR supportedMIBsBehaviour BEHAVIOUR
  2919.                  DEFINED AS
  2920.                  !This attribute specifies the set of Internet OIDs
  2921.                  of registered MIBs that the agent supports.!;;
  2922.                REGISTERED AS {iimcProxyAttributeID 5 };
  2923.  
  2924.  
  2925.             snmpSecurity ATTRIBUTE
  2926.                WITH ATTRIBUTE SYNTAX
  2927.                  IimcProxyASN1.SnmpSecurity;
  2928.                MATCHES FOR EQUALITY;
  2929.  
  2930.             Chang             Expires November 29, 1993          Page 44
  2931.  
  2932.  
  2933.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2934.  
  2935.  
  2936.                BEHAVIOUR snmpSecurityBehaviour BEHAVIOUR
  2937.                  DEFINED AS
  2938.                  !This attribute specifies the default values to be used
  2939.                  when other AccessControl values are not available (i.e.,
  2940.                  when no AccessControl fields are received during
  2941.                  association establishment or on a given CMIS
  2942.                  operation).!;;
  2943.                REGISTERED AS {iimcProxyAttributeID 7 };
  2944.  
  2945.  
  2946.             --  7.1.3  Proxy MIB Name Bindings
  2947.  
  2948.  
  2949.             cmipsnmpProxy-systemNB  NAME BINDING
  2950.                SUBORDINATE OBJECT CLASS cmipsnmpProxy;
  2951.                NAMED BY SUPERIOR OBJECT CLASS
  2952.                  "Rec. X.721 | ISO/IEC 10165-2 : 1992": system;
  2953.                WITH ATTRIBUTE {iimcManagementDoc 1}:internetClassId;
  2954.                BEHAVIOUR cmipsnmpProxy-systemNBBehaviour BEHAVIOUR
  2955.                  DEFINED AS
  2956.                  !There is only one object instance of this object class
  2957.                  in the proxy and this managed object instance should be
  2958.                  created by the proxy process.  It is not creatable and
  2959.                  deletable via CMIP management operation.!;;
  2960.                REGISTERED AS {iimcProxyNameBinding 1};
  2961.  
  2962.  
  2963.             cmipsnmpProxyAgent-cmipsnmpProxyNB  NAME BINDING
  2964.                SUBORDINATE OBJECT CLASS cmipsnmpProxyAgent;
  2965.                NAMED BY SUPERIOR OBJECT CLASS cmipsnmpProxy;
  2966.                WITH ATTRIBUTE cmipsnmpProxyAgentId;
  2967.                BEHAVIOUR cmipsnmpProxyAgent-cmipsnmpProxyNBBehaviour
  2968.                BEHAVIOUR
  2969.                  DEFINED AS
  2970.                  !This managed object may be created and deleted
  2971.                  either by management action, or by local action, of
  2972.                  the proxy.
  2973.  
  2974.                  A side effect of the creation/deletion of this object
  2975.                  shall be the creation/deletion of the ISO system
  2976.                  managed object associated with the Internet agent.
  2977.  
  2978.                  The cmipsnmpProxyAgentId contains the DN of
  2979.                  the proxied device.!;;
  2980.  
  2981.                CREATE WITH-REFERENCE-OBJECT;
  2982.                DELETE;
  2983.                REGISTERED AS {iimcProxyNameBinding 2};
  2984.  
  2985.  
  2986.             snmpSecurityParameter-cmipsnmpProxyNB  NAME BINDING
  2987.                SUBORDINATE OBJECT CLASS snmpSecurityParameter;
  2988.                NAMED BY SUPERIOR OBJECT CLASS cmipsnmpProxy;
  2989.                WITH ATTRIBUTE {iimcManagementDoc 1}:internetClassId;
  2990.  
  2991.             Chang             Expires November 29, 1993          Page 45
  2992.  
  2993.  
  2994.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  2995.  
  2996.  
  2997.                BEHAVIOUR snmpSecurityParameter-cmipsnmpProxyNBBehaviour
  2998.                BEHAVIOUR
  2999.                  DEFINED AS
  3000.                  !This managed object is created automatically when the
  3001.                  containing cmipsnmpProxy object is created.!;;
  3002.                REGISTERED AS {iimcProxyNameBinding 3};
  3003.  
  3004.  
  3005.             7.2  Proxy MIB ASN.1 Module
  3006.  
  3007.  
  3008.             IimcProxyASN1 {iimcManagementModMan 3}
  3009.             DEFINITIONS IMPLICIT TAGS ::= BEGIN
  3010.             IMPORTS
  3011.                  iimcManagementProxy, iimcManagementModMan,
  3012.                  iimcManagementDocMan, iimcIIMCProxy
  3013.                       FROM IimcAssignedOIDs {iimcManagementModMan 1}
  3014.  
  3015.                  ObjectIdentifier, AccessControlInfo
  3016.                       FROM IimcCommonDef (iimcManagementModMan 2}
  3017.  
  3018.                  DistinguishedName
  3019.                       FROM InformationFramework { joint-iso-ccitt ds(5)
  3020.                       modules (1) informationFramework (1) };
  3021.  
  3022.             -- for ISO/CCITT-Internet proxy specific extension
  3023.             iimcProxySpecificExtension OBJECT IDENTIFIER
  3024.                          ::={iimcManagementProxy specificExtension(0)}
  3025.  
  3026.             -- for ISO/CCITT-Internet proxy object class
  3027.             iimcProxyObjectClass OBJECT IDENTIFIER
  3028.                          ::={iimcManagementProxy managedObjectClass(3)}
  3029.  
  3030.             -- for ISO/CCITT-Internet proxy package
  3031.             iimcProxyObjectClass OBJECT IDENTIFIER
  3032.                          ::={iimcManagementProxy package(4)}
  3033.  
  3034.             -- for ISO/CCITT-Internet proxy attribute
  3035.             iimcProxyAttributeID OBJECT IDENTIFIER
  3036.                          ::={iimcManagementProxy attribute(7)}
  3037.  
  3038.             -- for ISO/CCITT-Internet proxy name bindings
  3039.             iimcProxyNameBinding OBJECT IDENTIFIER
  3040.                          ::={iimcManagementProxy nameBinding(6)}
  3041.  
  3042.             -- SNMP Protocol version
  3043.             iimcSnmpProtocol OBJECT IDENTIFIER
  3044.                       ::= { iimcProxySpecificExtension snmpProtocol(1) }
  3045.  
  3046.             -- the OID for SNMPv1
  3047.             snmpV1 OBJECT IDENTIFIER ::= {iimcSnmpProtocol snmpV1(1) }
  3048.  
  3049.             -- the OID for SNMPv2
  3050.             snmpV2 OBJECT IDENTIFIER ::= {iimcSnmpProtocol snmpV2(1) }
  3051.  
  3052.             Chang             Expires November 29, 1993          Page 46
  3053.  
  3054.  
  3055.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3056.  
  3057.  
  3058.  
  3059.             -- the OID for IIMC errors
  3060.             iimcErrors OBJECT IDENTIFIER
  3061.                       ::= { iimcProxySpecificExtension errors(2) }
  3062.  
  3063.             snmpTooBig     OBJECT IDENTIFIER ::= { iimcErrors 0 }
  3064.             snmpBadValue   OBJECT IDENTIFIER ::= { iimcErrors 1 }
  3065.             snmpReadOnly   OBJECT IDENTIFIER ::= { iimcErrors 2 }
  3066.             snmpGenErr     OBJECT IDENTIFIER ::= { iimcErrors 3 }
  3067.             noResponse     OBJECT IDENTIFIER ::= { iimcErrors 4 }
  3068.             cannotDelete   OBJECT IDENTIFIER ::= { iimcErrors 5 }
  3069.             notImplemented OBJECT IDENTIFIER ::= { iimcErrors 6 }
  3070.             wrongLength    OBJECT IDENTIFIER ::= { iimcErrors 7 }
  3071.             wrongEncoding  OBJECT IDENTIFIER ::= { iimcErrors 8 }
  3072.  
  3073.  
  3074.             AccessControlUsed ::= INTEGER {
  3075.                                 noAccessControl (0),
  3076.                                 internet (1),
  3077.                                 iso (2)}
  3078.  
  3079.  
  3080.             AccessControlEnforcement ::= INTEGER {
  3081.                                      agent   (0),
  3082.                                      proxy   (1),
  3083.                                      both    (2)}
  3084.  
  3085.  
  3086.             SupportedMIBs ::= SET OF CHOICE {
  3087.                                 oid OBJECT IDENTIFIER,
  3088.                                 ps  PrintableString }
  3089.  
  3090.  
  3091.             ErrInfo ::= INTEGER {
  3092.                                    transport(0),
  3093.                                    authenticationProtocol(1),
  3094.                                    privacyProtocol(2) }
  3095.  
  3096.             SnmpSecurity ::=  SEQUENCE {
  3097.                            snmpOperation    SnmpOpType,
  3098.                            snmpSecurityInfo AccessControlInfo }
  3099.  
  3100.  
  3101.             SnmpOpType ::= ENUMERATED {
  3102.                          getReqPdu(0),
  3103.                          getNextReqPdu(1),
  3104.                          getRespPdu(2),
  3105.                          setReqPdu(3),
  3106.                          trapPdu(4),
  3107.                          getBulk(5),
  3108.                          informReq(6)     }
  3109.  
  3110.  
  3111.             END
  3112.  
  3113.             Chang             Expires November 29, 1993          Page 47
  3114.  
  3115.  
  3116.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3117.  
  3118.  
  3119.  
  3120.  
  3121.             8  Conformance Requirements
  3122.  
  3123.             8.1  Management Communication Requirements
  3124.  
  3125.             An implementation of the ISO/Internet proxy shall satisfy the
  3126.             following management communication requirements.
  3127.  
  3128.             -    The ISO/Internet proxy shall conform to ISO/CCITT CMIP in
  3129.                  the agent role, as specified by  [ISO9596-1] and
  3130.                  [ISO9595], and profiled by AOM12 [ISO11183-1,2].
  3131.  
  3132.             -    The ISO/Internet proxy shall conform to either Internet
  3133.                  SNMPv1 or SNMPv2 in the manager role, as specified by
  3134.                  [RFC1157] or [RFC1448].
  3135.  
  3136.             -    The ISO/Internet proxy shall conform to all mandatory
  3137.                  security requirements specified by [IIMCSEC] for each
  3138.                  supported version of SNMP (SNMPv1 and/or SNMPv2). If
  3139.                  proxy supports only SNMPv1, then enforcement of access
  3140.                  control and Party MIB support is optional.
  3141.  
  3142.             8.2  Management Function Requirements
  3143.  
  3144.             An implementation of the ISO/Internet proxy shall satisfy the
  3145.             following management function requirements.
  3146.  
  3147.             -    The ISO/Internet proxy may optionally conform to
  3148.                  ISO/CCITT system management functions in the agent role,
  3149.                  as specified by either [ISO10164-5] or [ISO10164-6], and
  3150.                  profiled by AOM221 [ISO12060-4] or AOM231 [ISO12060-5].
  3151.  
  3152.             8.3  Management Information Requirements
  3153.  
  3154.             An implementation of the ISO/Internet proxy shall satisfy the
  3155.             following management information requirements.
  3156.  
  3157.             -    The ISO/Internet proxy shall support the "system" object
  3158.                  specified by [ISO10165-2], in the agent role.
  3159.  
  3160.             -    The ISO/Internet proxy shall support the translated MIB-
  3161.                  II "internetSystem" object specified by [IIMCMIB-II], in
  3162.                  the manager role.
  3163.  
  3164.             -    The ISO/Internet proxy shall support the IIMC Proxy MIB
  3165.                  definitions specified by section 7 of this document, in
  3166.                  the agent role.
  3167.  
  3168.             -    The ISO/Internet proxy shall support the IIMC Party MIB
  3169.                  definitions specified by [IIMCSEC], in the agent role.
  3170.  
  3171.  
  3172.  
  3173.  
  3174.             Chang             Expires November 29, 1993          Page 48
  3175.  
  3176.  
  3177.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3178.  
  3179.  
  3180.             -    The ISO/Internet proxy shall support the Internet Party
  3181.                  MIB definitions specified by [RFC1447], in the manager
  3182.                  role.
  3183.  
  3184.             -    The ISO/Internet proxy shall support one or more
  3185.                  translated MIBs, derived in accordance with the
  3186.                  procedures specified by [IIMCIMIBTRANS]. For each
  3187.                  supported MIB, the ISO/CCITT GDMO translation shall be
  3188.                  supported in the agent role, and the Internet MIB shall
  3189.                  be supported in the manager role.
  3190.  
  3191.             -    The ISO/Internet proxy shall comply with the information
  3192.                  models specified by [ISO10165-1,4] and either [RFC1155],
  3193.                  [RFC1212], or [RFC1442].
  3194.  
  3195.             -    The ISO/Internet proxy may optionally support the "OP1
  3196.                  Library Vol.4":capabilityObject" specified by [NMF006],
  3197.                  in the agent role.
  3198.  
  3199.             8.4  Service Emulation Requirements
  3200.  
  3201.             An ISO/Internet proxy implementation that claims conformance
  3202.             to this specification must state the level of CMIS service
  3203.             emulation that it supports.  Two levels are defined:
  3204.  
  3205.             a)   a basic proxy which emulates CMIS kernel services, plus
  3206.                  support for scoped CMIS Get; and
  3207.  
  3208.             b)   an enhanced proxy which emulates all CMIS services,
  3209.                  including scoping and filtering on all applicable CMIS
  3210.                  services.
  3211.  
  3212.             As noted in section 8.1, the proxy requires support for the
  3213.             Enhanced Management Communications Profile AOM12. That is, the
  3214.             proxy is required to support CMIP kernel, multiple object
  3215.             selection, filtering, and multiple reply functional units.
  3216.             However, a basic proxy is not required to request the
  3217.             filtering functional unit. Furthermore, a basic proxy is not
  3218.             required to carry out scoping for CMIS services other than M-
  3219.             GET, and returns the CMIS error "complexity limitation" for
  3220.             any other CMIS service request which contains a Scope
  3221.             parameter value not equal to "base object alone". These
  3222.             limitations do not apply to the enhanced proxy, which is
  3223.             required to carry out both scoping and filtering for all CMIS
  3224.             service requests.
  3225.  
  3226.             Editor's Note: [Deletion of Conceptual Table Translation, as
  3227.             proposed in Appendix B of [IIMCIMIBTRANS], would require the
  3228.             basic proxy also to support an M-GET Filter value consisting
  3229.             of a single AVA on the objectClass attributeId.]
  3230.  
  3231.             9  Acknowledgments
  3232.  
  3233.             The following individuals have contributed to this effort.
  3234.  
  3235.             Chang             Expires November 29, 1993          Page 49
  3236.  
  3237.  
  3238.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3239.  
  3240.  
  3241.  
  3242.             Bob Aronoff              - NIST
  3243.             Jon Biggar               - NetLabs
  3244.             Mary Brady               - NIST
  3245.             April Chang              - NetLabs
  3246.             Ken Chapman              - Stratus Computer Inc.
  3247.             Alice Chen               - Boeing
  3248.             Christopher Crowell      - Cabletron Systems
  3249.             Jock Embry               - Opening Technologies
  3250.             Ian Emsley               - Bull S.A
  3251.             Paul Golick              - IBM
  3252.             Ulrich Gremmelmaier      - University of Stuttgart
  3253.             Pramod Kalyanasundaram   - University of Delaware
  3254.             Ken Hunter               - Hewlett-Packard
  3255.             Lee LaBarre              - The MITRE Corporation
  3256.             David Liu                - Northern Telecom
  3257.             Jim MacLeod              - U S West
  3258.             Reece Markowsky          - OSIWare
  3259.             Subrata Mazumdar         - IBM
  3260.             Keith McCloghrie         - Hughes LAN Systems
  3261.             Owen Newnan              - U S West
  3262.             Steve Ng                 - MPR Teltech
  3263.             Yasuhiro Ohara           - NTT
  3264.             Jong-Tae Park            - KyungPook National University
  3265.             George Pavlou            - University College of London
  3266.             Lisa Phifer              - Bellcore
  3267.             Jim Reilly               - Technical Rsch Ctr of Finland
  3268.             Tom Rutt                 - AT&T
  3269.             Adarsh Sethi             - University of Delaware
  3270.             Raj Sirsikar             - University of Delaware
  3271.             Baltej Singh             - OSIWare
  3272.             Mark Smith               - Hewlett-Packard
  3273.             Einar Stefferud          - Network Management Associates
  3274.             Mark Sylor               - Digital
  3275.             Hector Trevino           - Bellcore
  3276.             Huy Truong               - Tandem
  3277.             Al Vincent               - U S West
  3278.             Dean Voiss               - NetLabs
  3279.             David Waitzman           - BBN
  3280.             Graham Wisdom            - Timeplex
  3281.             Yoshi Yamashita          - NKK Corporation
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.             Chang             Expires November 29, 1993          Page 50
  3297.  
  3298.  
  3299.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3300.  
  3301.  
  3302.  
  3303.  
  3304.             References
  3305.  
  3306.             [ISO7498-4] ISO/IEC IS 7498-4, Information Processing Systems
  3307.             - Open Systems Interconnection -Basic Reference Model Part 4 -
  3308.             Management Framework, 1989.
  3309.  
  3310.             [ISO8824] ISO/IEC 8824: Information Technology - Open System
  3311.             Interconnection - Specification of Abstract Syntax Notation
  3312.             One (ASN.1),1990.
  3313.  
  3314.             [ISO8825] ISO/IEC 8825: Information Technology - Open System
  3315.             Interconnection-Specification of Basic Encoding Rules for
  3316.             Abstract Syntax Notation One (ASN.1),1990.
  3317.  
  3318.             [ISO9595] ISO/IEC 9595, Information Technology - Open System
  3319.             Interconnection - Common Management Information Service
  3320.             Definition, 1991.
  3321.  
  3322.             [ISO9596-1] ISO/IEC 9596-1, Information Technology - Open
  3323.             Systems Interconnection - Common Management Information
  3324.             Protocol - Part 1: Specification, 1991.
  3325.  
  3326.             [ISO10164-5] ISO/IEC 10164-5: Information Technology - Open
  3327.             Systems Interconnection - Systems Management - Part 5: Event
  3328.             Report Management Function, 1991.
  3329.  
  3330.             [ISO10164-6] ISO/IEC 10164-6: Information Technology - Open
  3331.             Systems Interconnection - Systems Management - Part 6: Log
  3332.             Control Function, 1991.
  3333.  
  3334.             [ISO10164-9] ISO DIS 10164-9, Information Processing Systems -
  3335.             Open Systems Interconnection - Structure of Management
  3336.             Information - Part 9: Objects and Attributes for Access
  3337.             Control, ISO/IEC JTC1/SC21/N7661, March, 1993.
  3338.  
  3339.             [ISO10165-1] ISO/IEC 10165-1: Information Technology - Open
  3340.             Systems Interconnection - Structure of Management Information
  3341.             - Part 1: Management Information Model, 1991.
  3342.  
  3343.             [ISO10165-2] ISO/IEC 10165-2: Information Technology - Open
  3344.             Systems Interconnection - Structure of Management Information
  3345.             - Part 2: Definition of Management Information, 1992.
  3346.  
  3347.             [ISO10165-4] ISO/IEC 10165-4: Information Technology - Open
  3348.             Systems Interconnection - Structure of Management Information
  3349.             - Part 4: Guidelines for the Definition of Managed Objects,
  3350.             1991.
  3351.  
  3352.             [ISO11183-1] ISO/IEC ISP 11183-1, Information Technology -
  3353.             International Standardized Profiles AOM1n OSI Management -
  3354.             Management Communications Protocols - Part 1: Specification of
  3355.  
  3356.  
  3357.             Chang             Expires November 29, 1993          Page 51
  3358.  
  3359.  
  3360.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3361.  
  3362.  
  3363.             ACSE, Presentation, and Session Protocols for the use by ROSE
  3364.             and CMISE, May 1992.
  3365.  
  3366.             [ISO11183-2] ISO/IEC ISP 11183-2, Information Technology -
  3367.             International Standardized Profiles AOM1n OSI Management -
  3368.             Management Communications Protocols - Part 2: AOM12 - Enhanced
  3369.             Management Communications, June 1992.
  3370.  
  3371.             [ISO12060-4] ISO/IEC DISP 12060-4, Information Technology -
  3372.             International Standardized Profiles AOM2n OSI Management -
  3373.             Management Functions - Part 4: AOM221 - General Event Report
  3374.             Management, July 1992.
  3375.  
  3376.             [ISO12060-5] ISO/IEC DISP 12060-5, Information Technology -
  3377.             International Standardized Profiles AOM2n OSI Management -
  3378.             Management Functions - Part 5: AOM231 - General Log Control,
  3379.             July 1992.
  3380.  
  3381.             [RFC1155] RFC1155, M. Rose and K. McCloghrie, Structure and
  3382.             Identification of Management Information for TCP/IP based
  3383.             internets, May 1990.
  3384.  
  3385.             [RFC1157] RFC1157, J.D. Case, M.S. Fedor, M.L. Schoffstall,C.
  3386.             Davin, Simple Network Management Protocol (SNMP), May 1990.
  3387.  
  3388.             [RFC1212] RFC1212, M. Rose, K. McCloghrie - Editors, Concise
  3389.             MIB Definitions, March 1991.
  3390.  
  3391.             [RFC1213] RFC1213, K. McCloghrie and M. Rose - Editors,
  3392.             Management Information Base for Network Management of TCP/IP-
  3393.             basedinternets: MIB-II, March 1991.
  3394.  
  3395.             [RFC1441] J.D. Case, K. McCloghrie, M.T. Rose, S.L.Waldbusser,
  3396.             Introduction to version 2 of the Internet-standard Network
  3397.             Management Framework, April 1993.
  3398.  
  3399.             [RFC1442] J.D. Case, K. McCloghrie, M.T. Rose, S.L.Waldbusser,
  3400.             Structure of Management Information for version 2 of the
  3401.             Simple Network Management Protocol (SNMPv2), April 1993.
  3402.  
  3403.             [RFC1446] J.M. Galvin, K. McCloghrie, J.R. Davin, Security
  3404.             Protocols for version 2 of the Simple Network Management
  3405.             Protocol (SNMPv2), April 1993.
  3406.  
  3407.             [RFC1447] J.D. Case, K. McCloghrie, M.T. Rose, S.L.
  3408.             Waldbusser, Party MIB for version 2 of the Simple Network
  3409.             Management Protocol (SNMPv2), April 1993.
  3410.  
  3411.             [RFC1448] J.D. Case, K. McCloghrie, M.T. Rose, S.L.Waldbusser,
  3412.             Protocol Operations for version 2 of the Simple Network
  3413.             Management Protocol (SNMPv2), April 1993.
  3414.  
  3415.  
  3416.  
  3417.  
  3418.             Chang             Expires November 29, 1993          Page 52
  3419.  
  3420.  
  3421.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3422.  
  3423.  
  3424.             [RFC1450] J.D. Case, K. McCloghrie, M.T. Rose, S.L.Waldbusser,
  3425.             Management Information Base for version 2 of the Simple
  3426.             Network Management Protocol (SNMPv2), April 1993.
  3427.  
  3428.             [RFC1452] J.D. Case, K. McCloghrie, M.T. Rose, S.L.Waldbusser,
  3429.             Coexistence between version 1 and version 2 of the Internet
  3430.             Network Management Framework, April 1993.
  3431.  
  3432.             [IIMCIMIBTRANS] ISO/CCITT and Internet Management Coexistence
  3433.             (IIMC): Translation of Internet MIBs to ISO/CCITT GDMO MIBs,
  3434.             Draft 2, May 1993.
  3435.  
  3436.             [IIMCMIB-II] ISO/CCITT and Internet Management Coexistence
  3437.             (IIMC): Translation of Internet MIB-II (RFC1213) to ISO/CCITT
  3438.             GDMO MIB, Draft 2, May 1993.
  3439.  
  3440.             [IIMCSEC] ISO/CCITT and Internet Management Coexistence
  3441.             (IIMC): ISO/CCITT to Internet Management Security, Draft 2,
  3442.             May 1993.
  3443.  
  3444.             [IIMCOMIBTRANS] ISO/CCITT and Internet Management Coexistence
  3445.             (IIMC): Translation of ISO/CCITT GDMO MIBs to Internet MIBs,
  3446.             Draft 2, May 1993.
  3447.  
  3448.             [NMF006] Network Management Forum: Forum 006, OMNIPoint 1
  3449.             Library Volume 4, Issue 1.0, August, 1992.
  3450.  
  3451.             [NMFTR107] NM Forum and X/Open, ISO/CCITT and Internet
  3452.             Management: Coexistence and Interworking Strategy, Issue 1.0,
  3453.             October, 1992.
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.             Chang             Expires November 29, 1993          Page 53
  3480.  
  3481.  
  3482.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3483.  
  3484.  
  3485.             Appendix A (Normative) Managed Object Conformance Statements
  3486.             (MOCS)
  3487.  
  3488.  
  3489.             Editor's Note: [This section will be filled in prior to
  3490.             publication. When completed, this section will contain a
  3491.             tabular representation of the managed object classes,
  3492.             attributes, notifications, and name bindings defined in this
  3493.             document. The format of these proforma tables will be as
  3494.             defined by ISO/IEC 10165-6.]
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.             Chang             Expires November 29, 1993          Page 54
  3541.  
  3542.  
  3543.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3544.  
  3545.  
  3546.  
  3547.  
  3548.             Appendix B (Informative) Example Operation
  3549.  
  3550.  
  3551.  
  3552.             Operation: CMIS M-GET request
  3553.             Object class: Internet MIB-II ip
  3554.             Object instance:{systemTitle = "NetLabs"/internetClassId = ip}
  3555.             Scope: 2nd level down
  3556.             Filter: ipRouteType == indirect
  3557.             Attribute id list: ipRouteDest
  3558.  
  3559.             Example Internet MIB-II ipRouteEntries:
  3560.  
  3561.                          ipRouteDest    ipRouteType    Other object types
  3562.                          192.95.93.1    direct
  3563.                          192.95.93.2    indirect
  3564.                          192.95.93.3    invalid
  3565.                          192.95.93.4    other
  3566.                          192.95.93.5    indirect
  3567.                          (end of the table)
  3568.  
  3569.             The following sections show an example of how the
  3570.             ISO/Internet proxy fulfills the above CMIS M-GET request
  3571.             based on the example Internet MIB-II ipRouteEntries.
  3572.  
  3573.             1. Check the existence of the base object
  3574.  
  3575.             The ISO/Internet proxy issues an SNMP GetNext Request.
  3576.  
  3577.                          GetNextRequest { ip }
  3578.                          GetResponse { ipForwarding = 1 }
  3579.  
  3580.             If the get is successful, the ISO/Internet proxy would have
  3581.             verified that the base object exists.
  3582.  
  3583.             2. Managed object selection
  3584.  
  3585.             Based on the name binding definition, the following object
  3586.             classes are found in the "object class group":
  3587.  
  3588.                  a) ipAddrEntry
  3589.                  b) ipRouteEntry
  3590.                  c) ipNetToMediaEntry
  3591.  
  3592.             For each object in the "object class group", the object
  3593.             instances may be retrieved via SNMP GetNext Requests.
  3594.  
  3595.                  a) ipAddrEntry: The definition for this object class 
  3596.                     does not contain the attribute specified in the 
  3597.                     filter (ipRouteType), therefore the ISO/Internet 
  3598.                     proxy concludes that there are no object instances 
  3599.                     with ipAddrEntryobject class in the scope.
  3600.  
  3601.             Chang             Expires November 29, 1993          Page 55
  3602.  
  3603.  
  3604.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3605.  
  3606.  
  3607.  
  3608.                  b) ipRouteEntry:  The definition for this object class
  3609.                     contains the attribute specified in the filter
  3610.                     (ipRouteType),therefore the ISO/Internet proxy
  3611.                     issues SNMP GetNext Requests to retrieve the object
  3612.                     instances.
  3613.  
  3614.                     The SNMP requests issued and the responses received
  3615.                     would be as follows:
  3616.  
  3617.                       GetNextRequest  {ipRouteDest, ipRouteType}
  3618.                       GetResponse     {ipRouteDest.192.95.93.1 = 
  3619.                                                     192.95.93.1,
  3620.                                        ipRouteType.192.95.93.1 = direct}
  3621.  
  3622.                       GetNextRequest  {ipRouteDest.192.95.93.1,
  3623.                                       ipRouteType.192.95.93.1}
  3624.                       GetResponse     {ipRouteDest.192.95.93.2 = 
  3625.                                                     192.95.93.2,
  3626.                                        ipRouteType.192.95.93.2 = 
  3627.                                                     indirect}
  3628.  
  3629.                       GetNextRequest  {ipRouteDest.192.95.93.2,
  3630.                                        ipRouteType.192.95.93.2}
  3631.                       GetResponse     {ipRouteDest.192.95.93.3 = 
  3632.                                                     192.95.93.3,
  3633.                                        ipRouteType.192.95.93.3 =
  3634.                                                          invalid}
  3635.  
  3636.                       GetNextRequest  {ipRouteDest.192.95.93.3,
  3637.                                        ipRouteType.192.95.93.3}
  3638.                       GetResponse     {ipRouteDest.192.95.93.4 = 
  3639.                                                     192.95.93.4,
  3640.                                        ipRouteType.192.95.93.4 =
  3641.                                                          other}
  3642.  
  3643.                       GetNextRequest  {ipRouteDest.192.95.93.4,
  3644.                                       ipRouteType.192.95.93.4}
  3645.                       GetResponse     {ipRouteDest.192.95.93.5 = 
  3646.                                                     192.95.93.5,
  3647.                                        ipRouteType.192.95.93.5 = 
  3648.                                                     indirect}
  3649.  
  3650.                       GetNextRequest  {ipRouteDest.192.95.93.5,
  3651.                                       ipRouteType.192.95.93.5}
  3652.                       GetResponse     {ipRouteIfIndex = 5,
  3653.                                        ipRouteProto = 1}
  3654.  
  3655.                  c) ipNetToMediaEntry: The definition for this object 
  3656.                     class does not contain the attribute specified in
  3657.                     the filter (ipRouteType), therefore the ISO/Internet
  3658.                     proxy concludes that there are no object instances    
  3659.                     with ipNetToMediaEntry object class in the scope.
  3660.  
  3661.  
  3662.             Chang             Expires November 29, 1993          Page 56
  3663.  
  3664.  
  3665.             Draft      ISO/CCITT to Internet Management Proxy    5/26/93
  3666.  
  3667.  
  3668.                     There are a set of five object instances in the       
  3669.                     scope. After the filter is applied to these five      
  3670.                     object instances, there are only two object
  3671.                     instances left on which the CMIS M-GET operation
  3672.                     is performed.
  3673.  
  3674.             3. Form the response
  3675.  
  3676.             The following CMIS responses should be formed and sent back
  3677.             to the ISO/CCITT manager
  3678.  
  3679.                          CMIS M-GET Response (first linked reply PDU):
  3680.                               Object class: ipRouteEntry
  3681.                               Object instance:/systemTitle =
  3682.                            { "NetLabs"/
  3683.                            internetClassId = ip/
  3684.                            internetClassId = ipRouteTable/
  3685.                            internetClassId = ipRouteEntry.192.95.93.2 }
  3686.                               Attribute list: ipRouteDest = 192.95.93.2
  3687.  
  3688.  
  3689.                          CMIS M-GET Response (second linked reply PDU):
  3690.                               Object class: ipRouteEntry
  3691.                               Object instance: { /systemTitle = 
  3692.                            "NetLabs"/ internetClassId = ip/
  3693.                            internetClassId = ipRouteTable/
  3694.                            internetClassId = ipRouteEntry.192.95.93.5 }
  3695.                               Attribute list: ipRouteDest = 192.95.93.5
  3696.  
  3697.                          CMIS M-GET Response (final empty response PDU)
  3698.  
  3699.                             {internetClassId = ip }
  3700.  
  3701.  
  3702.  
  3703.                       INTERNET DRAFT - Expires November 29, 1993
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.             Chang             Expires November 29, 1993          Page 57